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PREFACE 


The Macro Assembler for the CONTROL DATA® 1700 Computer bystem is a 3-pass 
assembler which can convert source language input including macro instructions to 
relocatable output and generate list output. The source programs are written with 
symbolic machine, pseudo, and macro instructions. 

Macro definitions may be defined by the user within the source program, or they may 
be placed on a separate macro library. 

Input is from the standard input device, binary output is to the standard output device, 
and list output is to the standard list device. 

The following describe functions occurring in each pass of the assembler. 

Pass 1 

Programmer defined macros are processed and appropriate tables are built. 
Whenever a macro instruction is encountered, the macro skeleton with actual 
parameters substituted is inserted into the source input on the mass storage device. 

The source input is copied onto the mass storage device. 

Sequence numbers of the input source images are checked. 

Pass 2 

Each source image on the mass storage device is read and pass 2 errors are 
listed as they occur. 

Conditional assembly pseudo instructions are processed. 

Symbol and external tables are built. 

Pass 3 

Each image is read and pass 3 errors are listed. 

List and relocatable binary output are generated according to the input options. 
TABLST 


TABLST pi'inta and punciieB the enti'y points and external images. The transfer 
image is punched. 

An EOF image is output to the next load-and-go sector on mass storage. 

A symbol table listing is given. 


iii 
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XREF 


XREF creates and prints the cross-references lists. 

Refer to the 1700 Mass Storage Operating System (MSOS) 4 Reference Manual equipment 
configuration for the minimum hardware required by the Macro Assembler. 

It is assumed that users of this manual are familiar v.'ith the 1700 MSOS. 


Following is a list of 1700 MSOS manuals. 


Description 

Pub. No. 

1700 MSOS 4 Reference Manual 

60361500 

1700 MSOS 4 Mass Storage FORTRAN 
Version 3 A/B Reference Manual 

60362000 

1700 MSOS 4 Computer System Codes 

60163500 

17 QQ MSOS 4 IVIscro AsssmblsF 
General Information 

39519800 

1700 MSOS 4 Mass Storage FORTRAN 
General Information 

39519900 

1700 MSOS 4 Small Computer Maintenance 
Monitor Reference Manual 

39520200 

1700 MSOS 4 Instant 

39520500 

1700 MSOS 4 File Manager Version 1 
Reference Manual 

39520600 

1700 MSOS 4 Release Bulletin 

39520800 

1700 MSOS 4 Installation Handbook. 

39520900 

1700 MSOS 4 Small Computer Maintenance 
Monitor Instant 

39521700 

1700 MSOS 4 Ordering Bulletin 

39521900 

1700 MSOS 4 General Information 

39522400 
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INSTRUCTION FORMAT 


1 


« « «• A I I M ^ r ^ M A «• 

l.l 9V^UKV.C rKKJK9Kf\m 

The number of independent subprograms com*prising a source program is limited only 
by available space. Each subprogram may be assembled independently, or several 
may be assembled as a group. The main subprogram of a group is the one to which 
initial control is given; it need not be the first subprogram. The last subprogram 
of a group must be followed by the MON pseudo instruction indicating the end of assem- 
bly and return to the operating system. 

Communication between subprograms is effected by the subprogram linkage pseudo 
instructions and by the use of common and data storage. 

At execution time, the entry point named in the END pseudo instruction specifies the 
entry point to which initial control passes. A jump to the dispatcher or an exit 
request (1700 MSOS Reference Manual) signals return of control to the operating 
system upon job completion. EXIT or a jump to the dispatcher must be the 
last statement to be executed. 


12 SOURCE STATEMENT 

A source statement consists cf location, instructions, address, remarks, and se- 
quence fields. The first four fields may not exceed 72 characters; within that limi- 
tation they are free field. The sequence field is used when the source image is 80 
characters; it is restricted to columns 73 through 80. 

Each field is terminated by a tab ($B; paper tape only), carriage return (end of state- 
ment mark), or blanks. Any number of blanks may separate fields. A carriage re- 
turn is always the end of statement mark on paper tape. 

1.2.1 LOCATION FIELD 

The location field of a source statement must begin in column 1. 

This field is used to specify a labeled (label starting in column 1) or an unlabeled (blank 
or tab in column 1) statement. 

The statement label is a symbolic name consisting of from 1 to 6 alphanumeric char- 
acters; the first must be alphabetic. Characters in excess of six are ignored. A 2- 

character name makes the most efficient use of storage and assembly time. 

Examples ; 

LOOPl Legal 

123456 Illegal; first character is numeric 

PI Legal 

A123456 Legal; only A12345 is processed 
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1.2.2 REMARKS 


An asterisk in column 1 of the location field specifies that the source statement is a 
remark. Comments, written in columns 2 through 72, are printed with the assembly 
list output but have no effect on the object program. An asterisk elsewhere in the 
location field is illegal. Remarks may also follow the address field of any instruction. 
There must be at least one blank separating the address field from the remarks. 


1.2.3 INSTRUCTION 


This field begins to the right of the location field and must be separated from it by at 
least 1 blank character or a tab. If the location field contains no label (blank or tab 
on column 1), the operation code may begin in column 2. 

The operation code field contains the three-letter instruction codes for machine and 
pseudo instructions; or it contains macro instructions which may be up to 6 characters. 
Certain instructions may be followed by a 1 -character terminator. 


T1i6 111110111 onic iiisti uction codes listed in Appendix A 
Computer Reference Manual. 


Ill tiie 


1 ^7 nn 

X I V c 


1.2.4 ADDRESS FIELD 

The address field begins to the right of the operation code field, separated from it by 
at least 1 blank character or a tab. It is terminated by a blank or tab, or by the 
72nd character of the source statement. Exceptions are the macro instructions which 
may have a continuation line and the pseudo instruction ALF (section 3.3.2). 

This field contains an address expression consisting of an operand or string of oper- 
ands joined by arithmetic operators; or it may contain a series of operands separated 
by commas. An operand may be any of the following: 

Symbolic name 

Numeric constant 

One of the special characters: * A Q M 0 I B 


Symbolic Operand 

A symbolic name used as an operand in the address field must be defined in one of 
the following ways. 

Label in the location field of any machine instruction 
Label in the location field of any macro instruction 

Label in the location field of constant declaration pseudo instructions: 

ADC, ALF, NUM, DEC, VFD 

Symbolic name in the address field of the pseudo instructions: EXT, 

COM, DAT, BSS, BZS, EQU 
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A defined symbolic name references a specific location in memory. It may be re- 
locatable or absolute. A relocatable symbol refers to a location that may be relocated 
during loading. 

Storage is divided into three areas: program, data, and common. These areas are 
defined at assembly time and the initial location of each is set to a relocation address 
of zero. The object code produced by the assembler contains addresses which are 
modified by a relocation factor to produce the actual address in memory. 

A symibol is program relocatable if it references a location in the subprogram, data 
relocatable if it references a location in data storage, and common relocatable if it 
references a location in common storage. All other symbols are absolute. A symbol 
is made absolute by equating it to a number, an arithmetic expression, or another 
absolute symbol. 

In all cases a symbolic label and a symbol defined by BSS or BZS take the relocation 
and value of the current location counter. The location counter of a program is 
originally program relocatable, however, its relocation may be changed by the ORG 
instruction. 

An address expression which includes more than one operand must reference only one 
relocatable area. Terms of different relocation types must reduce to one relocatable 
area or to an absolute address. When the address mode of an instruction is made 
one-word relative by an asterisk terminator , the relocation type of the address ex- 
pression must agree with the type of the cui-rent location counter. 

A symbolic opei'anu may tie preceaca oy a plus or a minus sign, it preceOect by a plus 
or no sign, the symbol refers to its associated value; if preceded by a minus, the 
symbol refers to the ones complement of its associated value. When an expression 
contains more than one symbol, the final sign of the expression is the algebraic sum 
of the operands. 

Example: 

RT relocation type of current location counter: P program relocatable, C common 

relocatable, D data relocatable, and A absolute address. 


RT Label 

Operation 


Address 


COM 

COMl, 

COM2 


DAT 

DATl, 

DAT2 


EQU 

D(l), E(3).G(E-D), H{$1000),I(DAT1) 

P 

BZS 

A,B,C 


P 

BZS 

J,K(10) 


The symbols D, 

E, G, and H are 

absolute; DAT1,DAT2, and I are data relocatable; 

COMl and COM2 

are common relocatable; A, B 

, C, .1, and K are program relocatable. 

P STA..RT 

ADC 

n 

V/ 


P 

LDA* 

START 


P 

ST A* 

DATl 

(Error) 

P 

ST A* 

COMl 

(Error) 
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The errors resulted because the relocation types of the symbols in the address 
field do not match that of the location counter, and the one-word relative address 
mode was requested by an asterisk terminator. 

RT Label Operation Address 

P LDA+ (Not an error) 

Relocations need not match when mode is two-word absolute. 

P LDA START (O. K. , relocations match) 

P LDA COMl (Not an error) 

Assembler changes this instruction to two-word absolute because relocations do not 
match, but no error is indicated. 

P LDA COM2-DAT1+COM1-D+E-COM2+START-K+DAT2 

This address expression results in a common relocation type; all other relocations 
cancel out (refer to address expressions). 

ORG DATl 

ORG changes the relocation of the location counter to data. 


D 

LDA* 

START 

(Error) 

D 

ST A* 

DAT2±9 



ORG* 



ORG* 

returns the location 

counter to original relocation. 

P 

LDA* 

START 

(Not an error) 


ORG 

H 


A 

LDA* 

START 

(Error) 

A 

STA* 

DATl 

(Error) 

A 

LDA* 

$1001 


A 

STA- 

B 



ORG* 




END 




Numeric Operand 


A numeric operand in the address field may be decimal or hexadecimal. A decimal 
number is represented by up to five decimal digits and must be within the range 
± 32767. A hexadecimal number is represented by a dollar sign and not more than 
four hexadecimal digits in the range ±7FFF. (Hexadecimal operands in the NUM 
pseudo instruction may be in the range ±FFFF. ) 

Numeric operands in the address field may be preceded by a plus or a minus sign. If 
a plus or no sign is specified, the binary equivalent of the number is the value used; 
a minus means the one's complement of the binary equivalent is the value. 

A numeric operand has no relocation type; it is always absolute. 
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Audi' 6s 5 Expi cSSlOn 

An address expression rnay be a single operand or a string of operands joined by tue 
following arithmetic operators. 


J. 




Subtraction 
=!' Multiplication 
/ Division 

Arithmetic operators may not follow each other without an intervening operand. Paren- 
theses are not permitted for grouping terms. 

The asterisk has an additional meaning as an operand. When it is used as the mul- 
tiplication operator (refer to special characters), it must be immediately preceded by 
an operand which may be another asterisk. When the asterisk is used as an operator, 
only one of its associated operands may be relocatable. 

The slash, used as the division operator, must be between two operands. The operand 
which follows m3v not bo 'zero or r^locstsble. 


external name mav he nsed in an address exnnession onlv as a sintTl^^ operand 
Arithmetic operators preceding or following an external operand are illegal. 


Example: 


START 


NAM 

EXAM PL 

COM 

A,B 

EQU 

C(1).D(5) 

EXT 

G 

BZS 

E(10), F 

LDA 

D-C/5+**2 

ADD 

A-B/2 

ADD 

E+5 

STA 

END 

G 


The first asterisk in the LDA instruction refers to the value of the current location 
counter. 


The following instructions are illegal assuming the same pseudo instructions precede 
the START. 


START LDA 
ADD 
ADD 
STA 


D-C*='-5+2 

A-2/B 

E*F 

G45 


*5 has no intervening operator 
Division by relocatable operand 
Both operands are relocatable 
An external must stand alone 
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The hierarchy for the evaluation of arithmetic expressions is; 


/ or * Evaluated first 

+ or - Evaluated next 

Expressions containing operators at the same level are evaluated from left to right. 
The expression 

A/B+C*D 

is evaluated algrebraically as 
A/B+(C)(D) 

and not as any of the following; 

(A)(D) A A 

B+C (B+C)(D) B+(C)(D) 

Parentheses may not be used for grouping operands. The algrebraic expression 
(A-DKB+C/E) 
must be specified 

A*B+A*C/E-D*B-D=!'C/E 
The following expression is illegal. 

(A-D)*(B+C/E) 

Division in an address expression always yields a truncated result; thus, 11/3 = 3. The 
expression A'''B/C may result in a value different from B/C*A. For example, if A=4, 
B = 3, and C = 2 then 

A*B/C=4*3/2 = 6 but 
B/C*A = 3/2*4=4 

All expressions are evaluated modulo 2^^-l. An address expression consisting solely 
of numeric operands is absolute. If an expression contains symbolic operands, the 
final relocation for the expression is determined by the relocations of the symbolic 
operands. If the relocation of the operands is expressed by the following terms, the 
final relocation is the algebraic sum of the relocation terms. 

±P Positive or negative program relocation 

±C Positive or negative common relocation 

±D Positive or negative data relocation 

The relocation must reduce to one of the relocation terms or to zero. If zero, the 
location is absolute. 
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Example; 


Source Statements 


Relocation Formula 


STRT 


COM A.B 
DAT C.D 

TT</^TT Tn / -I \ TT»/T>\ 

riVl/. -T \LJI 

LDA B+C-E=^2-A-D 
LDA B+D-F+STRT-A-C 
LDA B+D-E+STRT-A-C 
LDA B-D-A 


+C+D-C-D = 0 (absolute) 
+C+D-D+P-C-D = P-D (illegal) 
+C+D+P-C-D = P (program) 
+C-D-C = -D (negative data) 


Special Characters 


Special characters may be used as operands in the address field of a source statement. 
Their definition may not be changed by the user. The three classes of special char- 
acters are storage, register, and index. 


Class 


Character 


Referenced Location 


Storage 



Current location counter 
Location FF^g 


A 

Q 

M 

0 


A register 
Q register 
Mask register 
Destination registers 


Q 

Index I 

B 


Index 1, Q register 
Index 2, location FFj 5 
Index 1 plus index 2 


Storage class characters (*, I) reference storage locations. The asterisk refers to the 
location of the current instruction. For a word instruction, an asterisk references the 
location of the first word. Special character I refers to location FF;^ 0 . 1 is the only 

indexing character that may stand alone as an operand with storage reference instructions. 
It may not be defined as a location symbol in a program. 

The register class characters (A, Q, M, and 0 ) are used only with inter-register transfer 
instructions. They refer to the A, Q, and M (mask) registers. Character 0 sets the 
destination registers to zero (section 2. 5). 


Examples: 

Instru ction Function 

SET A,Q, M Set A, Q, and mask registers to ones 

TRA Q Transfer contents of A register to Q register 

LAM M Transfer logical product of A and mask register to mask 

register 
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Index class characters (Q, I, and B) are used in conjunction with an address expression to 
refer to the index registers. Any one character may follow an address expression; it is 
separated from the expression by a comma with no intervening blank. Indexing may be used 
only with storage reference instructions. 


Q Contents of Q register are added to contents of the expression to form 

the actual address 

I Contents of location FFjg are added to contents of address expression 

to form the actual address 

B Contents of Q register are added to address expression and this sum is 

added to contents of FF^g to produce the actual address 

Examples: 


Function 


LOCl,B 

Legal 

Contents of registers Q and FFig and the contents 
of LOCI are added to produce the actual address 

..1 

Illegal 

Character following first comma is assumed to be 
index character 

TAG2,Q,I 

Illegal 

Only one index notation allowed 

Q 

Illegal 

Unless Q has been previously defined as a location 
symbol or is being used with the inter-register 
transfer instruction, it must follow a location symbol 

TAGS, I 

Legal 

Contents of FF^g and TAGS are added to produce 
the actual address 


1.2.5 COMMENT FIELD 

The address field is followed by the comment field which is used for remarks. Re- 
marks do not affect the object code, but are printed as part of the list output. The 
comment field terminates at column 72, or with a carriage return (paper tape). Blanks 
are permitted in the comment field. 


1.2.6 SEQUENCE FIELD 

When the input im.age is 80 characters, columns 73 through 80 are available for se- 
quencing; 73 through 75 may be used for program identification, 76 through 80 for a 
sequence number. 

Sequence numbers are checked for errors only if the input image is 80 characters. 
Each sequence number must be greater than or equal to the previous sequence number. 
The value of a character in the sequence number is in ASCII code except that a blank 
is treated as zero. 
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MACHINE INSTRUCTIONS 


2 


ivlachine instructions i epi e»euted by a three-ietter mnemonic code are divided into six 
classes. 


Group A storage reference 
Group B storage reference 
Register reference 


Shift 

Skip 

Inter-register transfer 


Storage reference instructions result in one or two machine words, depending on 
modification. Other machine instructions result in one machine word. 

The function of each machine instruction is discussed in detail in the 1700 Computer 
Reference Manual. Appendix A lists the machine instructions in the order in which 
they are discussed in this chapter. 


2.1 STORAGE REFERENCE INSTRUCTIONS 


Group A and B storage reference instructions use storage addresses as operands or as 
operand addresses. Group B instructions include jump instructions and may not use 
the constant mode of addressing. 


2.1.1 ADDRESS MODES 

Group A storage reference instructions allow three modes of addressing: absolute, 
relative, and constant. Group B does not allow the use of the constant mode, but is 
otherwise the same as Group A. 

Special characters designate the mode of addressing, the number of words for the 
instruction, and indirect addressing. 

Character Description 

* Asterisk as the last character of operation code specifies relative 

addressing in a one-word instruction 

Minus as the last character of operation code specifies absolute 
addressing in a one-word instruction 

+ Plus as the last character of operation code specifies absolute 

addressing in a two -word instruction 

= Equal sign as the first character in address field preceding a 

constant indicates constant addressing; the instruction is always 
two words 

0 Parentheses enclosing the address expression indicate indirect 

addressing 
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If no character is specified as a terminator to the operation code, two-word relative 
addressing is assumed with the following exceptions. 

1. If a constant is specified, the constant m.ode is assum.ed. 

2. If the relocation type of the address expression differs from the relocation 
type of the location counter, two-word absolute addressing is assumed. 

3. If a nonrelative external is referenced, absolute addressing is assumied. 

The machine language format resulting from a storage reference instruction is illustrated 
as follows. 

First word: 


15 

11 

10 

9 

8 

7 0 

f 

E 

d 

q 

1 ^ 1 

A 


f 4-bit operation code is described in 1700 Computer Reference Manual 
r Specifies relative addressing 

d Specifies indirect addressing 

q Index register 1 flag; specifies adding contents of Q register to address 

i Index register 2 flag; specifies adding contents of storage register FF^^0 

to address 

A 8-bit field; may be relative or absolute address for one-word instructions. 
When zero, indicates two-word instruction. 

Second word (when used); 

15 0 

c 


c 16-bit field for constant addressing or relative address. When it contains 
relative address, bit 15 is the sign. 


15 14 


m 


b Indirect address bit 

m Memory address 

Address expressions are evaluated modulo 
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2.1.2 ABSOLUTE ADDRESSING 


The value of the address expression of a one-word absolute instruction must be non- 
rclocatable. The evaluated result is stored in 8 bits of trie machine word. If this 

value is greater than 256, it is flagged as an error. If the 8-bit A field is zero, 
two machine words are assumed regardless of the operation code terminator; no error 
message is printed. If the address expr Gssion is 0 nclosGci 




in po n 0n+ 02 0 o 


WWJ.U i.O OCL X, 


Examples: 


One Word, Direct 


Instruction: 

EDA- e 
Machine Word: 


JU n 10 9 8 7 


EDA 0 

0 

0 

0 

e 

One Word, Indirect 


Instruction- 

ADQ- (e) 

Machine Word; 

15 11 10 

9 8 7 n 

ADQ 0 

1 

0 

0 

e 


The value of the address expression of a two-word absolute instruction is stored in 
the least significant bits of the second word. If the expression is enclosed in paren- 
theses for indirect addressing, bit 15 of the second word is set to 1. The indirect 
address bit 10 in the first word is always set to 1 when two-word absolute addressing 
is specified whether the address expression is specified as indirect or direct. This 
indicates that the address expression is in the second word. The 8-bit A field of the 
first word is set to zero for two-word instructions. 

Examples; 

Two Word. Direct 


Instruction: 

EOR+ e 
Machine Words: 


15 


11 

10 

9 

8 

7 

0 

EOR 

0 

1 

0 

0 

00 

15 

14 






0 

LiJ 

e 
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Two Word, Indirect 

Instruction: 

AND+ (e) 
Machine Words: 


15 


11 

10 

9 

8 

7 

0 

AND 

0 

1 ^ 

1 ° 1 

0 

00 

15 

14 






0 

[I] 

e 


2.1.3 RELATIVE ADDRESSING 

When one-word relative addressing is specified, the value of the current location 
counter is subtracted (16-bit ones complement arithmetic) from the evaluated address 
expression. The result is placed in the 8-bit A field. If the value of the result 
is outside the range ±TFi 0. an error condition is flagged. An error condition is 
also flagged if the relocation type of the address expression differs from that of the 
location counter. If the 8-bit A field is zero, two words are assumed regardless of 
the operation code terminator. No error message is printed for this condition. 

Examples: 

One Word, Direct 

Instru ction: 


AND* e 
Machine Word: 


15 11 10 9 8 7 0 

AND 

1 

0 

0 

0 

e - 

One Word, Indirect 

9 8 7 0 

Instruction: 

MUI* (e) 

Machine Word: 

15 11 10 

MUI 

1 

1 


0 

e-* 
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In the expression e the asterisk indicates the value of the current location counter. 

When a two-word instruction is specified, the value of the current location counter 
plus one is subtracted (using 16-bit I's complement arithmetic) from the value of 
the address expression to obtain the 16-bit second word. If the relocation type of the 
address expression differs from that of the location counter and the address does not 

r* OT py* pnr*p on pv+pnno1 +V-»n ooc? V.1 t » -i . . .. 

. txic asoeiiiDier lurues a. two-wora absolute instruction. if the 

address expression is an external reference, the instruction is absolute or relative 
depending on the definition of the external. 

Examples : 


Two Word, Direct 


Instruction: 

LDQ e 
Machine Words: 


15 

11 

10 9 

8 

7 


0 

LDQ 

1 

0 0 

0 

00 

.1^ 






i 



C “ ■' " 1 





Two Word, Indirect 

Instruction: 

LDA (e) 
JVIachine Words: 


15 

11 

10 

9 

8 

7 0 

LDA 

1 ^ 

1 

0 

0 

00 

15 





0 



e- 

- 1 




In the expression, e-*-l, the asterisk indicates the value of the current location counter. 
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2.1.4 CONSTANT ADDRESSING 


Constant addressing may be used only for Group A storage reference instructions. 


Constants i 

n n r* c 

Ik S>XiC 

field are preceded h>y an eoual sign and a oue-letter code. 

A constant 

may be one of the following: 

Code 

Type 

Meaning 

A 

aa 

2 alphanumeric characters 

N 

± ddddd 

5-digit decimal number with or without a leading sign 

N 

±$hhhh 

4-digit hexadecimal number preceded by $, with or without 
a sign 

X 

e 

Address expression evaluated modulo 2^^-l 

X 

(e) 

Address expression evaluated modulo 2^^-l, with bit 15 set 

Examples: 

DVI 

=N$1000 

(Hexadecimal constant) 

ADD 

=N-12345 

(Decimal constant) 

LDA 

=AXY 

(ASCII constant) 

AND 

=XTAGl+5 

(Address expression constant) 

An instruction containing 

a constant in the address field results in two machine words 

Example: 

Instruction 



DVI 

=nc 

(n is the code, c is the constant) 


Machine Words: 


15 

11 

10 

9 

8 

7 


0 

DVI 

1 0 1 

0 i 

1 0 1 

0 

0 

15 







0 

c 


2.1.5 DATA 

STQ (F==4) 

STA (F=6) 


TRANSMISSION INSTRUCTIONS 

Store Q. Store the contents of the 
specified by the effective address. 


Q register in the storage location 
The contents of Q are not altered. 


Store A. Store the contents of the A register in the storage location 
specified by the effective address. The contents of A are not altered. 
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SPA (F = 7) 



Store the contents of the A register in the storage 

XI XJ _ .1 1 _ A - 

Liic cilcuLivt; ciuaresb. v^iear ±\ it tne numoer ot 


1 bits in A is odd. Set A equal to 0001^0 if the number of 1 bits in A 
iS even. The contents of A are not altered if the write into storage is 
aborted because of parity error or protect fault. 


LDA (F = C) 


Load A. Load the A register with the contents of the storage location 

o T~\ -J -P-I /-i V\ TT ' i ■''L. ^ — j? X 1— a i 


kjpv^^xxxv^vx v..xx^ V., ux V c cxvxvax c:o o • XiJC Ui LliC lUCH” 

tion are not altered. 


LDQ (F = E) Load Q. Load the Q register with the contents of the storage location 
specified by the effective address. The contents of the storage loca- 
tion are not altered. 


2.1.6 ARITHMETIC INSTRUCTIONS 

All the following arithmetic operations use one's complement arithmetic. 

MUI (F = 2) Multiply Integer. Multiply the contents of the storage location, speci- 
fied by the effective address, by the contents of the A register. The 
32 -bit product replaces the contents of Q and A, the most significant 
bits of the product in the Q register. 

[') VI ( t ~ 3) Oivide Inteuer, Livide the ('ontents of the and d rcnistnx'o 

by the contents of the effectiv^e address. The Q register contains the 

r r 1 o s 1 9 I f n 1 1 H • H '■ 1 *■ ^ 1 1 t’ [- > t '' 'i r 1 1 !+’ 1 

into A, the sign bit of A must be extended throughout Q. The quotient 
is in the A register and the remainder is in the Q register at the end 
of the divide operation. 

The OVERFLOW indicator is set if the magnitude of the quotient is 
greater than the capacity of the A register. Once set, the OVERFLOW 
indicator remains set until a Skip On Overflow (SOV) or Skip On No 
Overflow (SNO) instruction is executed. 

ADD (F = 8) Add to A. Add the contents of the storage location, specified by the 
effective address, to the contents of the A register. 

The OVERFLOW indicator is set if the magnitude of the sum is 
greater than the capacity of the A register. Once set, the OVERFLOW 
indicator remains set until a Skip On Overflow (SOV) or Skip On No 
Overflow (SNO) instruction is executed. 

SUB (F = 9) Subtract From A . Subtract the contents of the storage location, 

specified by the effective address, from the contents of the A register. 
Operation on overflow is the same as for an Add to A instruction. 

RAO (F = D) Replace Add One in Storage. Add one to the contents of the storage 
location specified by the effective a.ddress. The contents of A are 
not altered. Operation on overflow is the same as for an Add to A 
instruction. 

ADQ (F = F) Add to Q. Add the contents of the storage location, specified by the 
effective address, to the coments of the Q register. Operation on 
overflow is the same as for an Add to A instruction. 
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2.1.7 LOGICAL INSTRUCTIONS 


The AND (AND with A) instruction achieves its results by forming a logical product. A 
logical product is a bit-by-bit multiplication of two binary numbers according to the 
following rules: 

0x0=0 1x0=0 

0x1 = 0 1x1 = 1 

Example: 

0011 Operand A 
X 0101 Operand B 

0001 Logical Product 

A logical product is used, in many cases, to select only specific portions of an operand 
for use in some operation. For example, if only a specific portion of an operand in 
storage is to be entered into the A register, the operand is subjected to a mask in A. 
This mask is composed of a predetermined pattern of Os and Is. Executing the AND 
instruction causes the operand to retain its original contents only in those bits which 
have Is in the mask in A. 

The EOR (Exclusive OR with A) instruction achieves its result by forming an exclusive 
OR. Executing the EOR instruction causes the operand to complement its original con- 
tents only in those bits which have Is in the mask in A. An exclusive OR is a bit-by-bit 
logical subtraction of two binary numbers according to the following rules: 

Exclusive OR 

A B 

1 1 
1 0 
0 1 
0 0 

Example: 

0011 Operand A 
X 0101 Operand B 

0110 Exclusive OR 

AND (F = A) AND with A. Form the logical product, bit-by-bit, of the contents of 
the storage location specified by the effective address and the contents 
of the A register. The result replaces the contents of A. The con- 
tents of storage are not altered. 

EOR (F = B) Exclusive OR with A. Form the logical difference (exclusive OR), 
bit-by-bit, of the contents of the storage location specified by the 
effective address and the contents of the A register. The result 
replaces the contents of A. The contents of storage are not altered. 


A 

0 

1 

1 

0 
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2.1.8 JUMP INSTRUCTIONS 


A Jump (JMP) instruction causes a current program sequence to terminate and initiates a 
new sequence at a different location in storage. The program address register, P, pro- 
vides continuity between program instructions and always contains the storage location of 
the current instruction in the program. 

When a Jump instruction occurs, P is cleared and a new address is entered.* In the 
Jump instruction, the effective address specifies the beginning address of the new pro- 
gram sequence. The word at the effective address is read from storage and interpreted 
as the first instruction of the new sequence. 

A Return Jump (RTJ) instruction enables the computer to leave the main program, jump 
to some subprogram, execute the subprogram, and return to the main program via 
another instruction. The Return Jump provides the computer with the necessary informa- 
tion to enable returning to the main program. Figure 2-1 shows how a Return Jump 
instruction can be used. 


MAIN 



Figure 2-1. 


Program Using Return Jump Instruction 


Jumps or return jumps from unprotected to protected storage cause a fault, but the 
address that is saved in the trap location is the destination address (i.e., the address 
of the next sequential main program instruction). 
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A Return Jump instruction is executed at main program address P. The computer jumps 
to effective address 0025^^0 and stores P + 1 or P + 2 (depending on the address mode of 
RTJ) at this location. Then the program address counter P is set to OO 2620 and the 
computer starts executing the subprogram. At the end of the subprogram, the computer 
executes a Jump instruction (JMP) with indirect addressing. This causes the computer 
to jump to the address specified by the subprogram address 0025^0 (P + 1 or P + 2 of 
the main program). Now main program execution continues at P + 1 or P + 2. 

JMP (F - 1) Jump. Jump to the address specified by the effective address. This 
effectively replaces the contents of program address counter P with 
the effective address specified in the Jump instruction. 

RTJ (F = 5) Return Jump. Replace the contents of the storage location specified 
by the effective address with the address of the next consecutive 
instruction. The address stored in the effective address is P + 1 
or P + 2, depending on the addressing mode of RTJ. The contents 
of P are then replaced with the effective address plus one. 


2.2 REGISTER REFERENCE INSTRUCTIONS 

Register reference instructions use the address mode field for the operation code. 
Register reference instructions are identified when the upper four bits (15 through 12) 
of an instruction are Os. 

Format: 


15 

0 0 0 


12 

0 


11 8 7 0 

FI 


Instruction Modifier (A) 


SLiS (F1=0) Selective Stop. Stops tlie computer if this instruction is executed 

when the selective stop switch is on. On restart, the computer exe- 
cutes the instruction at P+ 1. This becomes a Pass instruction 
when the selective stop switch is off. 


INP (FI = 2) Input to A. Reads one word from an external device into the A regis- 
ter. The word in the Q register selects the sending device. If the 
device sends a Reply, the next instruction comes from P+ 1 . If the 
device sends a Reject, the next instruction comes from P+l + A, 
where delta is an eight-bit signed number. If an internal Reject 
occurs, the next instruction comes from P + A . Refer to the 1700 
Computer Reference Manual. 

OUT (FI = 3) Output from A. Outputs one word from the A register to an external 
device. The word in the Q register selects the receiving device. If 
the device sends a Reply, the next instruction comes from P+ 1. If 
the device sends a Reject, the next instruction comes from P+1+ A, 
where delta is an eight-bit signed number. If an internal Reject occurs, 
the next instruction comes from P + A . Refer to the 1700 Computer 
Reference Manual. 
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INA (FI = 9) Increase A. Replaces the contents of A with the sum of the initial 

contents of A and delta, where delta is treated as a signed number with 
the sign extended into the upper eight bits. Operation on overflow is 
the same as for an Add to A instruction. 

ENA (FI -A) Enter A . Replaces the contents of the A register with the eight-bit 

Hpl + Q Cirfn 

NOP (F1 = B) No Operation . This is a Pass instruction (no operation is performed). 

Compares to Selective Stop instruction with the STOP switch off. 

ENQ (F1=C) Enter Q . Replaces the contents of the Q register with the eight-bit 
delta, sign extended. 

INQ (F1 = D) Increase Q. Replaces the contents of Q with the sum of the initial con- 

tents of Q and delta, where delta is treated as a signed number with 
the sign extended into the upper eight bits. Operation on overflow is 
the same as for an Add to A instruction. 

The following instructions (FI equals 4, 5, 6, 7, or E) are legal only if the program 
protect switch is off or if the instructions themselves are protected (refer to the 1700 
Computer Reference Manual). If an instruction is illegal, it becomes a selective stop 
and an interrupt on program protect fault is possible (if selected). 




kJ 1 1. V OLV./p 

^ T 4 . ... 

X1J.L3 ill. 


liiGss instructxoii ip prot6v_.tcd 

tlOij. OXCCutiOi'i (iiO diii pi 


EIN (FI =4) Enable Interrupt. Activates the interrupt system after one instruction 

following EIN has been executed. The interrupt system must be 
active and the appropriate mask bit set for an interrupt to be 
recognized. 

IIN (FI = 5) Inhibit Interrupt. Deactivates the interrupt system. If interrupt 

occurs during execution of this instruction, the interrupt is not recog- 
nized until one instruction after the next EIN instruction is executed. 

SPB (FI = 6) Set Program Protect Bit . Sets the program protect bit in the 
address specified by Q. 

CPB (FI = 7) Clear Program Protect Bit. Clears the program protect bit in the 
address specified by Q. 

EXI (F1=E) Exit Interrupt State. This instruction must be used to exit from any 
interrupt state. Delta defines the interrupt state from which the 
exit is taken (see 1700 Computer Reference Manual). At the time an 
interrupt occurs, the value of P is stored in the interrupt trap loca- 
tion assigned to that particular interrupt state. This value is called 
the return address as it enables return to the next unexecuted instruc- 

+ Q-p+or* r\r» r»r» ta c a i rv 'T’Hca TT^YT i r-» c3 + r» n + i o n +-r\i-r» o +-i 0*3 1 1 tr 

bWX A ^ W kJ W ^ k k Mk.- b X W'XX kX kX I, k^XXX CX WkX.X^ 

reads the address containing the return address, then jumps to the 
return address. In addition, if the computer is in 32K mode, this 
instruction also sets the OVERFLOW indicator to the state of bit 15 
in the return address. This bit records the state of the OVERFLOW 
indicator when the interrupt occurred. In 65K mode this instruction 
does not reset the OVERFLOW indicator. Refer to the 1700 Computer 
Reference Manual for an explanation of the overflow condition in 
65K mode. 
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2.3 INTER-REGISTER INSTRUCTIONS 


These instructions cause data from certain combinations of two origin registers to be 
sent through the adder to any combination of destination registers. Various operations, 
selected by the adder control lines, are performed on the data as it passes through the 
adder. 

Format: 


Adder 


Control 


Operand 1 


Lines 


Operand 2 


« '* > ' ( * t 

15 12 11 8 7 6 5 4 3 2 1 0 


0 

Fl=8 

L 

P 

X 

R 

A 

Q 

M 

A 

Q 

3 


Logical Product — 
Exclusive OR 


Destination 

Registers 


Origin 

Registers 


If bit 0 if an Inter- register instruction is set (M is the destination register) and the 
instruction is not protected, it is a program protect violation and becomes a non-protected 
Selective Stop instruction. The Program Protect Fault bit is set and interrupt occurs. 

See the 1700 Computer Reference Manual for additional information. 

The origin registers are considered as operands. There are two kinds. 

• Operand 1 may be: 

- FFFF (bit 5 is 0) or 

- The contents of A (bit 5 is 1) 

• Operand 2 may be: 

- FFFF (bit 4 is 0 and bit 3 is 0) or 

- The contents of M (bit 4 is 0 and bit 3 is 1) or 

- The contents of Q (bit 4 is 1 and bit 3 is 0) or 

- The inclusive OR, bit-by-bit, of the contents of Q and M (bit 4 is 1 and 
bit 3 is 1) 

The following operations are possible. 

• Exclusive OR (LP = 0 and XR - 1) — The data placed in the destination 
register(s) is the exclusive OR, bit-by-bit, of operand 1 and operand 2. 

• Logical Product (LP = 1 and XR = 0) — The data placed in the destination 
register(s) is the logical product, bit-by-bit, of operand 1 and operand 2. 

• Complement Logical Product (LP = 1 and XR = 1) — The data placed in the 
destination register(s) is the complement of the logical product, bit-by-bit, 
of operand 1 and operand 2. 
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• Arithmetic Sum (LP — 0 and XR — 0) — The data placed in the destination 
register(s) is the arithmetic sum of operand l and operand 2. The 
OVERFLOW indicator operates the same for an Add to A instruction. 


INTER-REGISTER MNEMONICS 


QTT'T^ /Tj’ 1 — O ^ j.\~^ — 1 _ n 

\-i.- X — u, I till UU^ll O — 1\J\JUKJ) 


CLR (FI = 8, bits 7 through 3 = 01000) 
TRA (FI = 8, bits 7 through 3 = 10100) 
TRM (FI = 8, bits 7 through 3 = 10001) 
TRQ (FI = 8, bits 7 through 3 = 10010) 

TEB (FI = 8, hits 7 through 3 = 10011) 

TCA (FI = 8, bits 7 through 3 = 01100) 

TCM (FI = 8, bits 7 through 3 = 01001) 

TCQ (FI == 8, bits 7 through 3 = 01010) 
TCB (FI = 8, bits 7 through 3 = 01011) 
AAM (FI = 8, bits 7 through 3 = 00101) 
AAQ (FI = 8, bits 7 through 3 = 00110) 
AAB (FI = 8, bits 7 through 3 = 00111) 
EAM (FI = 8, bits 7 through 3 = 01101) 
EAQ (FI = 8, bits 7 through 3 = OHIO) 
EAB (FI = 8, bits 7 through 3 = 01111) 
LAM (FI = 8, bits 7 through 3 = 10101) 
LAQ (FI = 8, bits 7 through 3 = 10110) 
LAB (FI = 8, bits 7 through 3 = 10111) 
CAM (FI = 8, bits 7 through 3 = 11101) 
CAQ (FI = 8, bits 7 through 3 = 11110) 
CAB (FI ~ 8^ bits 7 through 3 ~ 11111) 


Note: The "+" implies an inclusive OR. 


The use of bit 7 is optional; it may be a 


Set to Ones 
Clear to Zero 
Transfer A* 

Transfer M=!* 

Transfer Q* 

Transfer Q + M=!« 

Transfer Complement A* 

Transfer Complement M=!" 

Transfer Complement Q* 

Transfer Complement Q + M>i= 

Transfer Arithmetic Sum A, M 

Transfer Arithmetic Sum A, Q 

Transfer Arithmetic Sum A, Q + M 

Transfer Exclusive OR A, M 

Transfer Exclusive OR A, Q 

Transfer Exclusive OR A, Q + M 

Transfer Logical Product A, M 

Transfer Logical Product A, Q 

Transfer Logical Product A, Q + M 

Transfer Complement Logical Product A, M 

Transfer Complement Logical Product A, Q 

T'Q n O'Po V» T~« 1 O rw »-» + T r\ 1 "D /-v /I ^ 4- A -J_ T\/r 

^ ^ WiAb j~-t v./^ CLJ. X X. L I IVX 


1 or a 0. The assembler uses bit 7 = 0. 
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2.4 SHIFT INSTRUCTIONS 


The Shift instructions shift A, Q, or QA left or right the number of places specified by 
the five-bit shift count. Right shifts are end-off with sign extension in the upper bits. 
Left shifts are end-around. The maximum long-right or long-left shift is IF places. 

Format: 


15 12 11 8 7 6 5 4 0 


0 0 0 0 

P1=F 






1 = Shift Left 
0 = Shift Right 

1 = Shift A 

1 = Shift Q 


Shift 

Count 


Example: Shift A right two places — 0F42. 


15 

12 

11 8 

7 

6 

5 

4 0 

0 

F1=F 





0 0 0 

0 

1111 

0 

1 

0 

0 0 0 1 0 


SHIFT MNEMONICS 


ARS 

(FI = F, 

bits 

QRS 

(FI = F, 

bits 

LRS 

(FI = F, 

bits 

ALS 

(FI = F, 

bits 

QLS 

(FI = F. 

bits 

LLS 

(FI = F, 

bits 


7 through 5 = 010) 
7 through 5 = 001) 
7 through 5 = Oil) 
7 through 5 = 110) 
7 through 5 = 101) 
7 through 5 = 111) 


A Right Shift 
Q Right Shift 
Long Right Shift (QA) 
A Left Shift 
Q Left Shift 
Long Left Shift (QA) 


2-14 


60361900B 




2.5 SKIP INSTRUCTIONS 


Skip instructions result in one machine word: a 12-bit operation code and a 4-bit 
unsigned skip count. The first four bits of the operation code field are set to zero, 
the next four bits contain the skip instruction code 0001, and the last four bits con- 
tain a unique identifier, F2, for each skip instruction. The expression in the 
address field of the instruction is ev^aluated modulo 215-1. 

This expression may be absolute or relocatable. If absolute, the value of the expres- 
sion is the skip count. If relocatable, the value of the skip count is obtained by sub- 
tracting (16-bit one's complement arithmetic) the value of the current location counter 
plus one from the expression. The skip count is then placed in the last four bits of 
the machine word. The final value of the skip count must not exceed four bits or an 
error message is printed. If the expression is relocatable, the relocation type of the 
expression must match the relocation type of the location counter or an error results. 

Format: 


15 12 11 8 7 6 5 4 3 0 






^ )K n JL j 

Instruction (F) 

1 Skip Instruction ^ 

<t'2) 1 


Subinstruction (FI) Skip Count 


When the skip condition is met, the skip count plus one is added to P to obtain the 
address of the next instruction (e. g. , when the skip count is zero go to P + 1). When 
the skip condition is not met, the address of the next instruction is P + 1 (skip count 
ignored). The skip count does not have a sign bit. 

if A is positive zero (all bits are 0) 


SAZ (F2 = 0) 

Skip 

SAN (F2 = 1) 

Skip 

SAP (F2 = 2) 

Skip 

SAM (F2 = 3) 

Skip 

SQZ (F2 = 4) 

Skip 

SQN (F2 = 5) 

Skip 

cr>p /wo = 

\X- — V// 

Sirin 

SQM (F2 = 7) 

Skip 

SWS (F2 = 8) 

Skip 

SWN (F2 = 9) 

Skip 


if A is not positive zero (not all bits are 0) 

if A is positive (bit 15 is 0) 

is A is negative (bit 15 is 1) 

if Q is positive zero (all bits are 0) 

if Q is not positive zero (not all bits are 0) 

if O ie r\nGi+ix7i:i ^Hit 1.^ i<a 0^ 

if Q is negative (bit 15 is 1) 
if selective skip switch is set 
if selective skip switch is not set 
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SOV (F2 = A) 


SNO (F2 = B) 


SPE (F2 = C) 


SNP (F2 = D) 
SPF (F2 = E) 


SNF (Fs = F) 


Skip on Overflow. This instructions skips if 
an overflow condition is sensed. This instruc- 
tion clears the OVERFLOW indicator. 

Skip on No Overflow. This instruction skips 
if an overflow condition is not present. This 
instruction clears the OVERFLOW indicator. 

Skip on Storage Parity Error. This instruc- 
tion skips if a storage parity error occurred; 
it clears the Storage Parity Error Interrupt 
signal and the PARITY FAULT indicator. 

Skip on No Storage Parity Error. 

Skip on Program Protect Fault. The pro- 
gram protect fault is set by: 

• A nonprotected instruction attempting to 
write into an address that is protected. 

• An attempt to execute a protected 
instruction immediately following a 
nonprotected instruction, unless an 
interrupt caused the instruction 
sequence. 

• Execution of any nonprotected instruc- 
tion affecting interrupt mask or enables. 

The program protect fault is cleared when it 
is sensed by the SPF instruction. The program 
protect fault cannot be set if the program pro- 
tect system is disabled. (Refer to the 1700 
Computer Reference Manual.) 

Skip on No Program Protect Fault. 


2.6 NEGATIVE ZERO/OVERFLOW SET 

Negative zero and/or overflow set can be caused by two characteristics of the computer: 

• The computer has a one's complement subtractive adder. 

• Multiplication and division are done with positive numbers only. Therefore, 
a sign correction occurs, if required, before 3.ri(d after the multiplication 

or division symbols. 

Arithmetic operation that produce a negative zero result and/ or set overflow in the 
computer are: 

• Addition (~0) + (-0) = (-0) 

• Subtraction (-0) - (+0) ” ("0) 
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• Multiplication 


• Division 

Where: 


# 0 

= Remainder 


(+0) X 

(-N) 

= ( 

(-N) X 

(+0) 

= ( 

(-0) X 

(+N) 

= ( 

(+N) X 

(-0) 

= ( 

(+0) _ 
Fn) 

(-0), 

R 

(-0) _ 
T+n) 

(-0), 

R 

II 

(+0). 

R 

(+N) _ 

(+oT 

^ (-0), 

, R 

(-N) _ 

vw~ 

^ (-0). 

, R 

(-2N) 

— / o \ 

7+nT“ 


(-2N) 

(+2), 

(+0) _ 
Fo) 

(-0), 

R 

II 

(+0), 

R 

II 

(+0), 

R 

II 

(-0). 

R 


- 0 ) 

- 0 ) 

- 0 ) 

- 0 } 

= (+ 0 ) 

= (- 0 ) 

= (- 0 ) 

. = (+N) overflow set 
. = (-N) overflow set 
R = (-0) 

= (+0) overflow set 
= (+0) overflow set 
= (-0) overflow set 
= (-0) overflow set 
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PSEUDO INSTRUCTIONS 


3 


Paeudo instructiona ountrul the aaaemblei-, provide subprogram linkage, control output 
listing, reserve storage, convert data, and so on. 

Pseudo instructions may be placed anywhere in a source language subprogram. How- 
ever, OPT or NAM must be the first statement of a subprogram and MON or END 
must be the last statement. 

3.1 SUBPROGRAM LINKAGE 

These instructions identify and link stibprograms; a symbolic name in the location field 
is ignored. 


3.1.1 NAM 

NAM identifies a source language subprogram and must be the first statement of the 

subprogram. Only tire assembler control pseudo instructiori OPT vsection 11,4,5) rnay 
precede it. 

The format is 

NAM s 

s An optional symbolic name of the subprogram which is printed as 
part of the assembly list output. 


3.1.2 END 


END must be the last statement of a source language subprogram. If END terminates 
a subprogram assembled separately or the last subprogram of a group, MON follows 
END. Otherwise END is followed by NAM or OPT. 


The format is 


END 


An optional symbolic name of an entry point to the first subprogram 
to be executed. If specified, s must be defined as an entry point 
in the subprogram to which control passes. This entry point may be 
in the same subprogram as the END statement or in a subprogram 


Example: 

END 


START 


START is the location of the first statement to be executed. 
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3.1.3 ENT 


The ENT instruction lists the symbolic names of entry points which may be referenced 
from other subprograms. 

The format is 


ENT sj, S2« . . . . Sj^ 

Sj^ Entry points listed in the address field of ENT and must be defined in 
the subprogram containing the ENT instruction. Sj^ must not refer to 
to a location outside the subprogram, common storage, or data 
storage. 

Example; 



NAM 

PROGl 


ENT 

ENTl. ENT2 

ENTl 

LDA 

XYZl 

ENT2 

STA 

XYZ2 


ENT 

ENTX 


END 

ENTl 


(Legal) 


(Illegal; ENTX not defined) 


3.1.4 EXT/ EXT* 

The EXT instruction lists the symbolic names of entry points in external subprograms 
which may be referenced from this subprogram. 

The format is 

EXT sj, S2» . . . , Sf, 

Entry points in the address field of EXT, which must be symbols defined 
in the subprograms they reference. s^ must not refer to symbols in 
the same subprogram. 

Example 1: 


NAM 





EXT 

ENT1.ENT2 

(Legal) 



ENTS LDA 

XYZ 




COM 

ENT5 




EXT 

ENTS 

(Illegal: ENTS 

is 

same subprogram) 

EXT 

ENT4 

(Legal) 



EXT 

ENT5 

(Illegal; ENTS 

in 

common storage) 

EXT 

ENTl 

(Legal; defined 

in 

same way as abov^ 

END 

• 
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Example 2: 


EXT ENT1.ENT2 

T r>A ppiMT-i 

J— IXI X X 

This reference to ENTl results in the following two machine words. 


15 

11 

10 

9 

8 

7 0 

LDA 

0 

1 

0 

0 

00 

15 





0 

external link 


External link is a pointer to the location of ENTl used by the loader at load time. 

The EXT* instruction is the same as EXT except that sj are absolute locations in EXT 
and references to Sj are made relative in EXT*. 

The format is 

EXT* Sj^,S2*...*s^ 

The plus terminator cannot be used with an operation code when the address references 
a relative external entry point. It is also illegal to enclose an external in parentheses 
in the address field of an ADC instruction (section 3.3.1). 

Examples: 


EXT* 

NA ME 1 , N A ME2 . N A ME 3 


LDA 

NAMEl 


LDA + 

NAMEl 

(Illegal) 

LDA 

(NAME2) 


ADC 

(NAME 3) 

(Illegal) 

EXT* 

NAMEl. NAME2 


LDA 

■NT A TX/TTT' 1 
X’lxi IVi-Jl/ A 
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This reference to NAMEl results in the following two machine words. 


15 11 10 9 8 7 0 



External link is a pointer to the location of NAMEl used by the loader at load time. 


3.2 DATA STORAGE 

The following instructions allocate data storage. BSS and BZS assign storage local to 
the subprogram in which they appear. COM and DAT assign data common to any 
number of subprograms. Symbolic names in the location fields of data storage instruc- 
tions are ignored. 

3.2.1 BSS 

The BSS instruction assigns symbolic names to segments of storage within the instruc- 
tion sequence of the subprogram. 

The format is 

BSS S]^(ej), 82 ( 62 ). .... Sj^(ej^) 

Sj name Symbolic name which defines the first location of the 

named segment. 

omitted When omitted from a subfield, a segment is assigned with 

the length e but no name is assigned to the segment. 

expression Corresponding expressions of the symbolic name which 
defines the length of the segment in words. Segments 
are assigned contiguously to form one block of data 
starting at location s^. The size of the block is equal 
to the sum of the sizes of trie segments. ej^ are eval- 
uated modulo 2 ^^-l and must be absolute. 

0 The associated symbolic name is assigned to the next 

segment which in effect assigns two names to that segment. 

omitted The length is assumed to be one computer word. 

symbolic Must be previously defined; can be assigned by an EQU 

name instruction. 


3.2.2 BZS 

This statement functions in the same way as the BSS, except that the specified storage 
locations are set to zero. 


The format is 


82(02), 82(62). .... 
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Example: 



NAM 



NAM3 

LDA 

XY Z 1 



BSS 

NAM4(3) 

(Assign 3 words to NAM4) 


BZS 

NAM5(5) 

N A M 1 , N A M2 ( S ) 

(Assign 5 words, set to zero, 

4-^ ■MAH/TCr\ 

Lu 


BSS 

(Assign 1 word to NAMl; assign 
9 words to NAM2) 



BSS 

NAM3 

(Illegal; NAM3 already assigned) 


BSS 

NAM6, (4) 

(Assign 1 word to NAM6, assign 
4 words to unnamed segment) 


BSS 

NAM7 

(Assign 1 word to NAM7) 


EQU 

NAM8(4),NAM9(2) 


BZS 

NAM10(NAM8-NAM9) 

(Assign 2 words, set to zero, to 
NAMIO) 


BSS 

NAM8(NAM10- 1) 

(Illegal; NAM8 already' assigned) 


BSS 

LOC1(0),LOC2 

(Assign the same word to LOCI and 
LOC2) 


END 



3.2.3 COM 





The COM instruction names and defines segments in a block of storage common to more 
than one subprogram. 

The format is 

COM Sjie^, S2(e2>, . . . . Sn(Sn) 

Sj^ name 

omitted 


expression 


omitted 

symbolic 

name 


Symbolic name which defines the first location of 
the named segment. 

When omitted from a subfield, a segment is 
assigned with the length e but no name is assigned 
to the segment. 

Corresponding expressions of the symbolic name 
which defines the length of the segment in words. 
Segments are assigned contiguously to form one 
block of data starting at location S]^. The size 
of the block is equal to the sum of the sizes of 
the segments. e^ are evaluated modulo 2^^-l and 
must be absolute. 

The associated syniboiic nanie is assigned tu the 
next segment which in effect assigns two names 
to that segm.ent. 

The length is assumed to be one computer word. 

Must be previously defined; can be assigned by 
an EQU instruction. 
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If a program includes more than one COM statement, they define consecutive segments 
of common storage in the order of their appearance. The area used by common 
storage is assigned by the loader at load time to locations outside the program area. 
Data in common storage cannot be preset by the ORG pseudo instruction. 

Example; 

NAM 
COM 
NAM3 STA 
COM 
EQU 
COM 
COM 

END 


3.2.4 DAT 

The DAT instruction reserves area for common storage which is assigned within the 
program area and may be preset with data or instructions by using the ORG pseudo 
instruction (section 3.4.2). 

The format is 

DAT sj(ei), 82 ( 62 ), .... Sjj(e^) 

Si name Symbolic name which defines the first location of the 

named segment. 

omitted When omitted from a subfield, a segment is assigned 

with the length e but no name is assigned to the 
segment. 

ej expression Corresponding expressions of the symbolic name which 

define the length of the segment in words. Segments 
are assigned contiguously to form one block of data 
starting at location Si. The size of the block is equal 
to the sum of the sizes of the segments. e^ ar.e 
evaluated modulo 215 - 1 and must be absolute. 

0 The associated symbolic name is assigned to the next 

segment which in effect assigns two names to that 
segment. 

omitted The length is assumed to be one computer word. 

symbolic Must be previously defined; can be assigned by an 

name EQU instruction. 


NAM4 

XYZl 

NAM7($1EF),NAM8 

NAM1(6),NAM2(2) 

NAM5(NAM1-NAM2) 

NAM6(NAM3) (Illegal) 
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3.3 CONSTANT DECLARATIONS 

These pseudo instructions introduce constant values into the instruction sequence. 


3.3.1 ADC/ ADC* 


TVio A nr* /A nr** t n a+y*iir»+i rvn r>ii»v» 1 ^ /.J i 

* **%» ^ I >.« V MM w A.AMAXAV.A V« V./ A Ak9 VMAX b 0 WX CAI.X(aXt^OO C .A.^X C7 O O 1 t_;i CtiitJ. 

inserts the results in line. When ADC is followed by an asterisk, the evaluated 
address expressions are made relative to the current location counter. The reloca- 
tion type of the expression must be the same as that of the location counter. The 
value of the locations counter is subtracted from the value of the evaluated expression 
(16-bit one's complement arithmetic) and the result is the 16-bit address constant. 


The format is 


s ADC 
s 


e. 

1 


Symbolic name in the location field which is as- 
signed to the first constant in the address field. 

Numerical constant or address expression to 
be evaluated. The result is evaluated modulo 
Bit 25 will be set if the expression is 
t?nclos 0 d in p3.renthes0s (indicating an 
indirect reference). The results corres- 
ponding to e. , eo, . . . , e,, are stored in con- 
secutive storage locations. 


Note: Indirect addressing cannot be specified in the ADC''- statement. 


3.3.2 ALF 

The ALF instruction translates a message into ASCII format. 

The format is 

s ALF n, message 

s Symbolic name in the location field which is as- 

signed to the first constant in the address field. 

n Unsigned integer specifying the number of 

words to be stored; 2n equals the number of 
characters. 

If n is an integer, 2n characters of the mes- 
sage are stored. Excess characters are 
treated as a remark. (The ALF statement, 
including the message, will not be processed 
beyond the 72nd character of the source 
image.) If the message is less than 2n char- 
acters, the unused portion of the specified 
area is blank filled. 
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Noninteger character which signals the end of 
the message. When n is a special terminating 
character, the storage of the message ter- 
minates the first time this character is 
encountered in the message if it occurs 
before the 72nd character. If the Character 
just prior to n is the first character of a 
word, a blank is placed in the second char- 
acter to complete the word, 

A character message is stored into consecu- 
tive locations in the instruction sequence. 

The message is converted to ASCII charac- 
ters (Appendix C) and stored two 8-bit 
characters per word. 

The following typewriter control characters may be input with the ALF statement. 

Code Meaning Hexadecimal Value 

:R Carriage return D 

:T Horizontal tab 9 

:L Line feed A 

:B Bell 7 

;F Top of form C 

:V Vertical tab B 

These codes are converted to a single output character with the corresponding hexa- 
decimal value and are counted as one character in determining the value of n, when 
n is an integer character count. A colon is an 8 to 5 key punch code with the ASCII 
value of 3Aj0. 

A symbolic name in the location field is assigned to the first word to the message. 
Example; 

The following source language statements 

ALF 4,EXAMPLE1 

NAMl ALF .,EXAMPLE2 

ALF 6, EXMP3:TEXMP4:R 

NAM2 ALF 4, EXMP5 

are translated into machine words. 
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Character 


Location Left Right 


E X 

A M 

P L 

K 1 

NAMl E X 

A M 

P L 

E 2 

A A 


NAM2 


A 

E 

M 

3 
E 
M 

4 
E 
M 

5 

A 


A 

X 

P 

tab 

X 

P 

carriage return 
X 
P 
A 
A 


In this example A is a blank. Three dots indicate blanks fill in the words between 
EXAMPLE2 and EXMP3. This is because the special terminating character, 
does not occur in the message before the 72nd character. If, in the example, n is 
in column 13, then 25 words of blanks are used to fill the words between 
EXAMPLE2 and EXMP3. 


3.3.3 NUM 

The NUM instruction defines numeric constants. 


The format is 

s NUM kj.k2. 




Symbolic name in the location which is assigned to the first 
constant in the address field. 

Specified integer constants stored into consecutive locations 
in the instruction sequence. Each constant may be a decimal 
integer within the range ± 32767, or a hexadecimal integer 
preceded by a $ within the range ±7FFF. The constant may 

^ o 4 rfy^ o i ic CJ o 1 ^ ^ r\ 

Xi> XO XXWl. £7XglXW«a^ bxx€ V« «_/XXO VAXXb Xt9 CX0 MXXXV..\.X bV/ 

positive. When the sign is minus, the one's complement of 
the number is used. 
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Examples: 

The following source language statements 

NUM 1,2,3,$A 

NAMl NUM +14, -10, -$13B, $7FF 

are translated into machine words. 

Contents 


OOOE 

FFF5 

FEC4 

07FF 


Location 

C ontents 

Location 


0001 

NAMl 


0002 



0003 



OOOA 



3.3.4 DEC 

The DEC instruction converts decimal constants into fixed-point binary. 
The format is 


DEC 

s 


ki 


Symbolic name in the location which is assigned to the first constant 
in the address field. 

Specified integer constants stored into consecutive locations in the 
instruction sequence. It is a signed decimal integer followed by a 
decimal and/or binary scaling factor. The decimal scaling factor 
consists of the letter D followed by a signed or unsigned decimal 
integer. The binary scaling factor is the letter B followed by one or 
two signed or unsigned decimal digits. The form of a constant in 
the address field may be 

fDdBb 

which is equivalent to the algebraic expression 
f- 10‘^-2*^ 

The fixed-point binary number resulting from the conversion 
must have a m^nitude less than 2^5. If the result of scaling is 
greater than 2^^1, an error diagnostic is printed. 

A symbolic name in the location field is assigned to the location of the first constant. 

Example: 

The source language statements 



DEC 

35D-1B6 

NAMl 

DEC 

-35B6 


DEC 

32760B-4 

NAM2 

DEC 

32761D-5B15, +625D 

NAM3 

DEC 

10D3 


are converted to machine words. 
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Location Contents of Bits 15 through 0 

0000000011100000 
NAMl 1111011100111111 

6066011111111111 

NAM2 0010100111101111 

0000000000110010 
NAM3 0010011100010000 


3.3.5 VFD 


The VFD (variable field definition) instruction assigns data to consecutive locations in the 
instruction sequence without regard for computer words. Data is stored in bit strings 
rather than word units; it may be numeric constants, ASCII characters, or expressions. 
A symbolic name in the location field is assigned to the first word of data. 

The format is 

s VFD m.n /v , m„n„/v„, . . . , m n /v 
111 III nnn 


s name 

m. 

1 

N 


A 


X 


Symbolic name which defines the first location of the 
named segment. 

Specifies the mode of the data. 

When the value of the data is a numeric constant, the mode 
is specified as N and the number of bits must not be great- 
er than 16. If n is larger than necessary, the value is 
right justified in the field and the sign extended in the 
remaining high order bits. If n is less than is required, 
the value is truncated and the least significant bits are 
stored. The value, v, is a decimal integer or a hexadeci- 
mal integer preceded by a dollar sign. Integers may be 
signed or unsigned; if the sign is omitted, the number is 
assumed to be positive. A decimal number must be within 
the range ±32767 and a hexadecimal integer within the 
range ±7FFF. 

When V is string of characters, m must be A and n must 
be a multiple of 8. The number of characters in the string 
should be equal to n/8 including embedded blanks. The 
last character must be followed by a blank or a comma. 

The characters are converted to ASCII code and stored as 
in the ALF instruction (section 3.3. 2). 

When V is an expression, m must be X and n must be less 
than or equal to 16. If n is less than 16, the final value of 
the expression may be relocatable or absolute. It is eval- 
uated modulo 2-^^-l =7FFFj^g. If the final value is absolute 
and n exceeds the size required, the value is right justi- 
fied in the field. If absolute and n is less than the required 
size, the value is truncated and the least significant bits 
are stored in the field. If the final value is relocatable, 
n must equal 15 and the expression must be positioned so 
that it will be stored right justified at bit position 0 of the 
computer word. 
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If n equals 16, the expression must be absolute; it is 
evaluated using 16 -bit one's complement arithmetic. If a 
symbol is used in a 16-bit expression, bit 14 of the value 
of the symbol is extended to bit 15 and therefore the cal- 
culation of the value of the symbol is accurate only to 

For example, if the symbol A is equated to the 
value -1, the value of A in the symbol table is TFFE^g 
but the value used in the 16-bit calcxilation of this 
symbol is FFFE.g. Numeric operands used in a 16-bit 
expression may Be 16 bits in magnitude. 

n. Number of bits to be allocated 

1 

Vj^ Value of the data 

Examples: 

1. Source language statements 

NAM 

VFD N3/l,X5/6-4,Al6/XY,X4/NAMl-NAM2 

BSS NAM2(3),NAM1 


END 

result in machine words 
Word Contents 


15 12 7 0 


0 0 

1 

0 0 0 1 0 

o 
o ; 

0 

0 

0 

15 



7 



Q, 

0 1 

0 

1 1 0 0 1 

0 0 11 


0 

0 0 


2. Source language statements 
NAM 

VFD N8/-1, A8/L, N1/0,X15/NAM1 

BSS NAMl 


END 

result in machine words 
Word Contents 


15 7 0 


l‘ 

1 1 

1 1 

1 1 0 

0 

1 0 0 110 0 

15 

14 




0 

1 0 

loc of NAMl 
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3. Source language statements 
NAM 

EQU A(-1),B(2) 

VFD X16/A.X16/B,X16/$7FFF*2 

END 

result in machine words 
Word Contents 


15 g 


1 ‘ 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

3 

15 















0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

1 

3 

15 















0 

1 

1 

i 

1 

1 

i 

i 

i 

1 

i 

1 

i 

1 

1 

1 

1 


3.4 ASSEMBLER CONTROL 

The assembly process is controlled or modified by these pseudo instructions. A 
symbolic name in the location field is ignored except where specifically noted. 


3.4.1 EQU 


The EQU instruction equates each symbolic name to the expression value. 
The format is 


EQU 


s, (e. ), s„(e„), .... s^(e^) 
n n 

s^ name Symbolic name s^ is equated to the value 


e^ expression Any symbolic operand used in the expression must 
be previously defined and not external to the 
subprogram in which the EQU statement appears. 

6j are evaluated modulo 2^^-l and must be absolute. 

omitted The expression is assumed to be zero. 
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Example: 


NAM 

PICKUP LDA 

NAM6 ADD 

EQU 
EQU 
EQU 

STORE STA 

EQU 


END 


3.4.2 ORG/ORG* 

The ORG statement specifies an address expression to which the current location 
counter is set. 

The format is 

ORG e 

1 5 

e expression The expression, e, is evaluated modulo 2 -1 and 

the location counter is set to the resultant value. 

The value of the expression may be program or data 
relocatable, or absolute; if relocatable, it must be 
positive. Any symbolic operands in the expression 
must have been previously defined. 

The instructions following an ORG statement are assembled into consecutive locations 
beginning at the location of the evaluated address expression, e. This sequence may 
be changed by another ORG, or terminated by an ORG='‘ statement. Within the range 
of a data relocatable ORG any reference to an external symbol is illegal. 

ORG=:= 

This instruction is used to return to the normal instruction sequence previously 
interrupted by an ORG. More than one ORG may be specified without an intervening 
ORG-'=; however, when an ORG* does occur, the location counter is reset to the value 
it had prior to the first ORG. 


EXAMPL 

XYZl 

XYZ2 

NAM3($4F), NAM4(-39) 
NAM7(NAM6-1) 

NAM8(STORE) (Illegal) 

XYZ3 

NAM9(STORE) (Legal) 
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Example: 


BSS ORG1(10).ORG2,ORG3(5) 
NAMl ENA 0 

NAM2 JMP* NAM3 
ORG NAMl 

(sequence of code beginning at NAMl) 
ORG* 

(resume sequence of code at NAM2+1) 
NAM3 JMP* NAM4 
ORG ORGl 

(sequence of code beginning at ORGl) 
ORG ORG3 

(sequence of code beginning at ORG3) 
ORG* 

(resume sequence of rode at NAM3 + 1) 


END 

3.4.3 IFA 

The IFA instruction assembles a set of coding lines only if a specified condition is true. 

The format is 

s IFA ei,c,e 2 

s The symbolic name in the location field is used as an identifying tag only; 

it is not defined as a location symbol within the program. If specified, the 
first 2 characters of the identifier, s, must match the first 2 
characters of the symbolic name in the address field of the corre- 
sponding EIF. If s is blank in an IFA statement, it must also be 
blank in the corresponding EIF. 

ej The expressions e^ and 62 are evaluated modulo 2^^-l and must 

result in an absolute value. Any symbolic name in either expression 
must have been previously defined. 

c If the conditions specified by c exist between ej and 62 , the code is 

assembled; if the condition does not exist, the code following the IFA 
statement is skipped until a corresponding EIF statement is encountered. 
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following conditions 

may be specified 

Condition 

Meaning 

EQ 

®1 " ^2 

NE 

ei i e2 

GT 

ei > 02 

LT 

e, < e„ 


3.4.4 EIF 


The EIF instruction signals the termination of an IFA or IFC instruction (section 4.1.4) 
when coding lines are skipped as a result of an untrue condition. When the condition 
in the IFA or IFC is true, EIF is ignored. 


The format is 
EIF s 

s The symbolic name, s, in the address field establishes the 

correspondence between an IFA or IFC and an EIF instruction. 
The first 2 characters of s must be the same as the first 2 
characters in the location field of the corresponding IFA or IFC. 
An EIF with a blank address field terminates an unlabeled IFA or 
IFC. 

Example; 



NAM 


LOCI 

BSS 

A(20),B(10),C(2) 


EQU 

NAMl(lO), NAM4(B),NAM2(2) 

NAM3 

IFA 

NAMl, EQ, NAM2+8 

OPl 

SAZ 

1 


EIF 

NAM3 


IFA 

NAMl, GT, NAM2+8 

OP2 

SAZ 

EIF 

2 


END 
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OPl is assembled and OP2 is skipped if the value of NAMl equals the value of NAM2+8; 
OPl is skipped and OP2 is assembled if the value of NAMl is greater than the value of 
NAM2+8; both OPl and OP2 are skipped if the value of NAMl is less than thp valna of 
NAM2+8. 


3.4.5 OPT 

The OPT pseudo instruction signals the input of control options to the assembler. 

The format is 
OPT 

When OPT appears, the assembler requests input of control options by typing 
OPTIONS 

The following control options are entered in any order on the teletypewriter. Imbedded 
spaces and illegal characters are ignored. A carriage return signals the end of control 
options input. 

Option Meaning 

L List output on standard list device 

P Pancn ouipuL uu siandarU punch uevice 

X Execute output on mass storage device 

M List called macro skeletons 

A Abandon all remaining assemblies and return control to operating system 

Ilu Input from unit lu. Reads instructions until the END statement is 

encountered, then returns to the standard input device; lu may be any 
ASCII or BCD input device. 

C List cross references at end of assembly listing. 

OPT is not a part of the source language program. It is used strictly for control of the 
assembler and has no code associated with it. 

OPT may precede any NAM instruction in any subprogram. If the first statement encoun- 
tered is not OPT, standard options are assumed until END is encountered. If OPT is 
encountered between the first statement of a program and the END statement, a diagnostic 
is issued. The standard options are L, P, X, and C. Chapter 5 describes output result- 
ing from the standard options. 


3.4.6 MON 

The MON instruction returns control to the operating system after the last subprogram has 
been assembled. 
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The format is 


MON 

MON may be used only after the END statement. The location and address fields are 
ignored. This statement is part of the source language program and is used strictly 
for control of the assembler; no code is associated with it. 


3.5 LISTING CONTROL 

The following pseudo instructions control the printing of assembly output. The location 
and address fields are ignored unless specified. 


3.5.1 NLS 

The NLS instruction inhibits list output. 

The format is 
NLS 

Normally list output is enabled initially until an NLS occurs and then remains inhibited 
until an LST instruction or the end of the program occurs. 


3.5.2 LST 

The LST instruction initiates list output after an NLS has inhibited it. 

The format is 
LST 

3.5.3 SPC 

The SPC instruction controls line spacing on the list output unit. 

The format is 
SPC e 

e Number of lines to be skipped; the expression is evaluated modulo 
215-1 and must be absolute. 

3.5.4 EJT 

The EJT instruction causes page ejection during printing of the list output. 

The format is 
EJT 
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MACROS 


4 


An often used set of instructions may be grouped together to form a macro. Once a 
macro is defined, it may be used as a pseudo instruction. The 1700 Macro Assembler 
includes two types of macros. 

Programmer defined Macros which must be declared by MAC pseudo instructions 

immediately following the NAM image. Comment cards 
may, however, be placed anywhere in the macro definition. 

Library Definitions contained on the system library and may be 

called from any subprogram. 


4.1 MACRO PSEUDO INSTRUCTIONS 

These pseudo instructions are used only within a macro definition. 


4.1.1 MAC 


i he ivlxiC iiisii uctiuii lb 1 equii eu d.nd utiiiies d maci o and lisia its lui'inai parairietei'S. 
The location field contains the name used to call the defined macro. It may be any 
name which is not a machine or pseudo instruction. 

The format is 

s MAC Pi,P2,...,Pn 

s A symbolic name in the location field is assigned to the first word of 

the generated code. 

Pi Symbolic names which are local to the macro definition and may be 

used anywhere else in the program without ambiguity. The formal 
parameters must conform to the following rules. 

They must be symbolic names of 1 or 2 characters 

The parameter list must not extend beyond the 72nd character 
of the line containing MAC 

The parameter list must terminate with a blank or the 72nd 
character of the line 

Each parameter in the list is separated from the next by a comma 
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4.1.2 EMC 


The EMC instruction is required and signals the end of a macro definition. A symbolic 
name in the location or address field is ignored. EMC is always the last instruction 
in a macro definition. 

The format is 

EMC 


4.1.3 LOC 

The LOC instruction is optional and allows the use of the same symbols in macros and 
programs to avoid doubly defined symbols. Symbols, other than formal parameters, 
that are local to the macro being defined are listed in this instruction. Local symbols 
have meaning only in the macro in which they are listed by LOC, thus allowing the 
same symbols to be used elsewhere in the program without ambiguity. 

The LOC instruction must immediately follow the MAC instruction. A symbol in the 
location field of the LOC instruction is ignored. 

The format is 

LOC S]^,S2,...»Sj^ 

s. Local symbols in the address field which must conform to the 
^ following rules. 

They must be symbolic names of 1 or 2 characters 

The list cannot extend beyond the 72nd character of the line 
containing the LOC instruction 

The list terminates with a blank or the 72nd character of the 
line 

Each symbol in the list is separated from the next by a comma 

No local symbol in the list may be the same as a formal 
parameter specified for the macro 

No more than 256 local symbols can be used in one program 

4.1.4 IFC 

The IFC instruction is optional and allows a set of instructions wdthin a macro 
definition to be assembled only if a specified condition is true. This instruction 
is meaningful only within the range of a MAC pseudo instruction. 
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The format is 


s IFC 
s 


ai 


c 


a 1 . r. ao 

1- - - i, 

The symbol in the location field is an identifying tag used to establish 
correspondence with the terminating EIF, An EIF terminates an IFC 
when the first two characters of the symbol in the address field of EIF 
are the same as the location symbol of the IFC, or when both symbols 
are blank and it is the first EIF encountered. 

Must be a string of from 1 to 6 characters or a formal parameter 
specified in the MAC statement. The character string should not 
contain commas, blanks, or apostrophes. Two character strings are 
equal when they contain the same characters in the same position and 
are of the same length. Characters in excess of six are ignored. 

Specified condition 


Condition Meaning 


EQ 

ai - a2 

NE 

ai 4 &2 


If the condition specified exists between aj and a 2 , the code is 
dtotoenibied; if iiut, the code fulluwiiiy the IFC skipped until <=i 
corresponding EIP’ pseudo instruction (section 3.4.4) is encountered. 

Source language examples of macro definitions and instructions are 
given in section 4.3.2. 


4.2 MACRO SKELETON 

A macro skeleton is the set of instructions within a macro definition that is the proto- 
type of the operations to be performed when the macro is called. 

The instructions may be any machine or pseudo instruction except MAC, LOG, EMC, 
NAM, END, or MON. A macro skeleton may also contain macro instructions calling 
other macros, A macro skeleton may not contain a macro instruction calling itself. 
Formal parameters, enclosed in apostrophes, may appear anywhere in the instruction 
format of a prototype instruction. Local symbols defined by a LOC statement may be 
used anywhere in the macro skeleton; they also must be enclosed in apostrophes. The 
only legal use of the apostrophe in a macro definition is to enclose formal parameters 
or local symbols. Formal parameters that extend past the 72nd character into the 
sequence field are ignored. Formal parameters in a remark statement signaled by 
an * in column 1 are also ignored. 

In addition to the formal parameters specified in the MAC pseudo instruction, a special 
formal parameter (a period enclosed in apostrophes) may be used in the macro skele- 
ton. It is replaced by the instruction terminator of the calling macro instruction 
when a terminator is specified. 

Let A, B, C, . . . be distinct arbitrary macro skeletons. A may contain a macro 
instruction calling B, B a macro skeleton calling C, etc. Up to ten such successive 
macro calls are allowed by the assembler. Further successive calls are ignored. 
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Example; 

XYZ MAC 

LOG 

EDA 
'P2' 
S'P4'Z 
JMP'. ' 
'A' ENA 

EMC 


4.3 MACRO INSTRUCTION 

With a macro instruction, the code generated from the named macro is inserted in the 

instruction sequence beginning at the location of the macro instruction. 

The format is 

s N Pi.P2.....Pn 

s A symbolic name in the location field is assigned to the first word of 
the generated code. 

N Symbolic name of the macro in the operation code field. It is the name 
specified in the location field of the MAC statement of the macro definition 
it calls. The macro name may be followed by one of the special termi- 
nators +, or *. 

Pi Symbolic names which are local to the macro definition and may be used 
anywhere else in the program without ambiguity. 

4.3.1 PARAMETERS 

Actual 


PI, P2, P3. P4, P5 
A 


'PI' 

'P3' 

'A 1 
'P5' 


Macro skeleton 


The actual parameters must be listed in the same order as the formal parameters in 
the MAC statement. The list of actual parameters must conform to the following rules. 

Each parameter in the list is separated from the next by a comma. 

The list is terminated with a blank or the 72nd character unless the 72nd character 
is a comma. 

The list may be continued onto the next line; if so, the last parameter on the list 
is terminated by a comma and a blank or the 72nd character. 

The continuation line must contain the macro name in the operation code field. A 
symbolic name in the location field is ignored. 

An actual parameter containing embedded blanks or commas must be enclosed by 
apostrophes. 
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The internal buffer for storage of actual parameters is 96 words long; this allows 
approximately three continuation lines. If the buffer overflows, an error message is 
given. 

Example: 

The macro defined in the previous example as XYZ could be called by the following 
macro instruction. 


TAGl XYZ* SYMBl. STA. 'SYMB2,I', 

XYZ* Q, LABELl (Continuation line) 

This macro instruction would generate the following code starting at location TAGl. 


TAGl 

LDA 

SYMBl 


STA 

SYMB2.I 


SQZ 

[nn-*- 1 


JMP* 

LABELl 

[nn 

ENA 

1 


NOTE 

[nn is a unique identifier assigned at assembly time. 


Null 

Actual paranieteis may be omitted from a macro insTrucTion. An omitted (nu!!' 
parameter in the middle of the list is indicated by its terminating comma only. 
Parameters at the end of the list may be omitted with no indication. 

Example; 

XYZ MAC PI. P2, P3, P4. P5. P6 

The macro instruction with P2. P4, and P6 omitted in the actual parameter list 
would be: 


XYZ MUl. .SYMB5..3 


Empty fields are allowed in all machine and pseudo instructions with the following 
exceptions. 

(n must be specified) 

(If e is specified, s 
must be specified) 

(c must be specified) 

Actual parameters to be inserted into the value of a VFD instruction using mode A 
must agree with the number of characters specified. A null actual parameter can 
cause an error in the generated code unless the VFD allows for null parameters. 


ALF 

n, message 

EQU 

s(e) \ 

COM 

s(e) 1 

DAT 

s(e) 1 

IFA 

ej.c. e2 \ 

IFC 

ai,c.a2 j 
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Example; 

X MAC P, Q, R 

VFD A8/ 'P',A8/ 'Q'. A8/ 'R' 

For the macro defined, the calling macro instruction must specify each actual parameter 
as 1 character long. If an actual parameter is more than 1 character, an error message 
is given. However, if an actual parameter is omitted, a code is generated and an error 
results. 

X A, , B (Q is omitted) 

VFD A8/A, A8/, A8/B (Code generated) 

If actual parameters might be omitted, the VFD instruction in the macro skeleton should 
include empty subfields for each character. 

Example: 

The macro definition should be written: 

X MAC P,Q,R 

VFD A8/'P',,A8/'Q',,A8/'R', 

A calling sequence with no actual parameters generates the following code and no 
error results. 

VFD A8/,,A8/,,A8/, 

I 4.3.2 EXAMPLES 

The following examples show macro definitions and the code generated by macro instruc- 
tions calling the defined macros. 

1. Macro Definition 

XYZ MAC 

LDQ 

•P4' LDA 

'PI' 

ADD 
IFA 

II IFC 

STA 
LDA 
EIF 
EIF 
EMC 

a. Macro Instruction 

CALLl XYZ MUI, 'SYMB4,I',SYMB5,HERE, 3,1 


P1,P2,P3,P4, P5,P6 
=N'P5', 'P6' 

'P3' 

'P2' 

SYMBl 
'P5', NE,0 
'P1',EQ,MUI 
SYMB3 
SYMB2 

II 
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Generated Code 


CALLl 

LDQ 

=N3,I 


HERE 

LUA 

SYMB5 



MUI 

SYMB4,I 



ADD 

SYMBl 



IFA 

3, NE, 0 

(Condition satisfied) 

11 

IrC 

MUI, iuQ, MUI 

(<Jondition satisfied) 


STA 

SYMB3 

(Assembled) 


EDA 

SYMB2 

(Assembled) 


EIF 




EIF 

11 


Macro Instruction 



CALL2 

XYZ 

DVI, SYMB7, 'SYMB8, 1', THERE, 2 

Generated Code 



CALL2 

LDQ 

=N2, 


THERE 

LDA 

SYMB8,I 



DVI 

SYMB7 



ADD 

SYMBl 



IFA 

2,NE, 0 

(Condition satisfied) 

T •» 
11 

IFC 

DVI, EQ, MUI 

(Condition not satisfied) 


STA 

SYMB3 

(Not assembled) 


LDA 

SYMB2 

(Not assembled) 


EIF 




EIF 

11 



2. Macro Definition 


A 

MAC 

P1,P2, P3,P4 

11 

IFC 

*, EQ, 'PI' 


LDA 

'P2' 


EIF 

11 

12 

IFC 

NE, 'PI' 


LDA 

'P3' 


EIF 

12 


STA 

EMC 

'P4' 


a. Macro Instruction 

A NAMl, NAM2, NAM3 

Generated Code 


11 

IFC 

EQ, 

(Condition satisfied) 


LDA 

NAM 1 

/ A O a QTVl ^ 

iij W 


EIF 

h 

12 

IFC 

=!<, NE, * 

(Condition not satisfied) 


LDA 

NAM2 



EIF 

12 



STA 

NAM 3 
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X k; 


3. Macro Definition 


MAC 

SY 

IFC 

*,EQ, 

SAZ 

EIF 

1 

IFC 

*,NE, 

SAZ 

EIF 

2 

JMP'. ' 
EMC 

'SY' 


a. Macro Instruction 

JAN* SYMBl 


Generated Code 


IFC 

*, EQ, * 

(Condition satisfied) 

SAZ 

1 

/Ac Cf or] ^ 



EIF 


(Ignored) 

IFC 

*, NE, * 

(Condition not satisfied) 

SAZ 

2 

(Not assembled) 

EIF 


(Skip terminated) 

JMP* 

SYMBl 


Macro Instruction 

JAN 

SYMB2 


Generated Code 

IFC 

*. EQ, 

(Condition not satisfied) 

SAZ 

1 

(Not assembled) 

EIF 


(Skip terminated) 

IFC 

*, NE, 

(Condition satisfied) 

SAZ 

2 

(Assembled) 

EIF 


(Ignored) 

JMP 

SYMB2 



4. Macro Definition 


IFEXMP 

Z 


Y 


MAC 

PI 


IFC 

*, EQ, 

'PI 

NUM 

2 


EIF 

Z 


IFC 

*, NE, 

'PI 

IFC 

0,EQ, 

'PI 

NUM 

1 


EIF 

X 


IFC 

0, NE, 

'PI 

NUM 

0 


EIF 

EMC 

Y 



a. Macro Instruction 


IFEXMP 
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Generated Code 


z 

IFC 

EQ, ^ 

(Condition satisfied) 


•NTTTTV/T 
\J xvx 

o 

/A _ _i\ 

\ri » B mu J. u/ 


EIF 

z 

Y 

IFC 

NE, * 

(Condition not satisfied) 

X 

IFC 

0, EQ, * 

(Not assenabled) 


NUM 

1 

/ IVT 1 <-l \ 

CLOa\^i.XlKJX^KA/ 


EIF 

X 

(Not assembled) 

Y 

IFC 

0, NE, * 

(Not assembled) 


NUM 

0 

(Not assembled) 


EIF 

Y 

(Skip terminated) 

Macro Instruction 




IFEXMP 

0 


Generated Code 



Z 

IFC 

"i<, EQ, 0 

(Condition not satisfied) 


NUM 

2 

(Not assembled) 


EIF 

Z 

(Skip terminated) 

Y 

IFC 

=:=, NE, 0 

(Condition satisfied) 

X 

IFC 

0, EQ, 0 

(Condition satisfied) 


NUM 

1 

(Assembled) 


EIF 

X 


Y 

IFC 

0, NE, 0 

(Condition not satisfied) 


NUM 

0 

(Not assembled) 


EIF 

Y 

(Skip terminated) 


c. Macro Instruction 

IFEXMP 


Generated Code 


Z 

IFC 

EQ. 

(Condition not satisfied) 


NUM 

2 

(Not assembled) 


EIF 

Z 

(Skip terminated) 

Y 

IFC 

NE, 

(Condition satisfied) 

X 

IFC 

O.EQ, 

(Condition not satisfied) 


NUM 

1 

(Not assembled) 


EIF 

X 

(Skip terminated) 

Y 

IFC 

0, NE, 

(Condition satisfied) 


NUM 

0 

(Assembled) 


EIF 

Y 



5. Macro Definitions 


DEPTH 1 

MAC 

A 


DEPTH2 

EMC 

•A', PARAMl 

DEPTH2 

MAC 

A,B 


DEPTHS 

EMC 

'A', PARAM2 

DEPTHS 

MAC 

C,D 


LDA 

'C 


STA 

EMC 

'D' 
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Macro Instruction 


DEPTHl SYMBl 

Generated Code 

DEPTH2 SYMBl, PARAMl 

DEPTHS SYMBl. PARAM2 

LDA SYMBl 

STA PARAM2 

6. Macro Definition 

B MAC A,B.C.D,E,F.G,H,I.J,K 

LOG LO 

ALF 'A', 'B' A ERROR 

VFD ’C'/'D', A16/’E'. , , A32/TEST 

IFC 'G'.EQ, SKIP 

LDA 'H' 

EIF 

INA 'J' 

'K' 1 

SAN 'LO' 

ENA -1 

'LO' STA 'F' 

EMC 


Macro Instruction 

B 4. 1.N4. -l.XY. 'TEMP, I'. SKIP. 'TEMP.l'. 

B NAM2. lO.NOP 


Generated Code 



ALF 

4.1 A ERROR 


VFD 

N4/-1,A16/XY, . , A32/TEST 


IFC 

SKIP. EQ. SKIP 


LDA 

TEMP. I 


EIF 


NAM2 

INA 

10 


NOP 

1 


SAN 

[nn 


ENA 

-1 

[nn 

STA 

TEMP.l 


4.4 MACRO LIBRARY 

LIBMAC is released as a separate library macro preparation routine. Input to this routine 
is in the form of a set of macro definitions, each starting with a MAC statement and ending 
with an EMC statement. The complete set of macro definitions to be input to the library 
is terminated by the characters ENDMAC starting in column 1 of the source image. 

The library macro preparation routine outputs two files on the standard I/O device for 
I binary output. One contains a macro directory; the other contains the macro skeletons. 
The routine checks for errors and prints an error message along with the line containing 
the error. 
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Binary output is in two sections, the macro skeleton file and the macro directory file. 
After the skeleton file has been output, the message MACSKL END is output on the 
typewriter and a carriage return must be typed to start output of the macro directory. 

The output files are placed on the program library in two permanent files using the 
system initializer or library editor of the 1700 MSOS. 




X HC XXUl CXX ^ CUltOl Ui LUC 

program library. 


1700 operating system is used to put the macros on the 


The control statement 


*N, MACROS, . , B 

places the macro directory file on the program library. 
The control statement 


*N, MACSKL, . , B 

places the macro skeletons on the program library. 

Refer to the 1700 MSOS Reference Manual for further information. 
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ASSEMBLER OUTPUT 


5 


C 1 


i^DTi/Mae 

wr 


Four standard options determine the type of output from the assembler. All four are 
automatically selected if no OPT statement is encountered before the first NAM. 

Option Meaning 

P Relocatable binary output on standard output unit. 

X Load and go; execute output loaded on a mass storage device. 

L List output on standard list unit. 

C List cross-references at end of assembly listing. 


5.1.1 P OPTION 


Relocatable binary output is selected by the 

^ -n.n '\TCOC T> AT.-.,-..,-.-! 


P option. 


The format is described in the 


The standard output binary device is used for relocatable binary information. If the binary 
output device is magnetic tape, the final relocatable program terminates with an EOL 
record, *T. If the binary output device is paper tape, a blank trailer terminates each 
assembly. 


5.1.2 X OPTION 

If the X option is selected, relocatable binary output is placed on the mass storage unit 
for subsequent loading and execution as described in the 1700 MSOS Reference Manual. 


5.1.3 L OPTION 

The L option results in an assembly listing described as follows. 

With the OPT pseudo instruction (section 3. 4. 5) any or all of the preceding options may 
be omitted. OPT also provides options for listing macro skeletons and abandoning assembly. 


5.1.4 C OPTION 

The C option produces a cross-reference list which is printed at the end of the assembly 
list (as described in section 5. 2. 2), 
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5.2 ASSEMBLY LISTiNO 


The assembly list, output to standard list output device, consists of 18 columns of 
information related to the source statement, followed by a maximum of 80 columns 
listing the source statement. 


Each page has a header containing the program name, page number, and date. 


Column 


C ontents 


1 through 4 

5 

6 


7 through 10 
11 

12 through 15 


Card number; truncated from 5 to 4 decimal digits 
Space 

Relocation designator for location 

P Program relocation 

D Data relocation 

Location in hexadecimed 
Space 

Machine word in hexadecimal 


16 through 17 


18 


Relocation designator for word 


p 

Program relocation 

-p 

Negative program relocation 

c 

Common relocation 

-c 

Negative common relocation 

D 

Data relocation 

-D 

Negative data relocation 

X 

External 

blank 

Absolute 


Space 


19 through 98 


Input source statement 


Following the assembly list, the lengths of the program, common, and data are given in 
hexadecimal and decimal values. 


PGM = 0155(341) COM = 2BE(702) DAT = 0000(0) 


The data length includes those areas reserved by DAT pseudo instructions. 


5.2.1 ERROR LISTING 

A list of errors occurring in passes 1 and 2 precedes the program listing on the standard 
list I/O unit. If the L option is selected, errors in pass 3 precede the source line on 
the list output. A decimal error count is printed at the end of each subprogram. If L is 
not selected, error messages are output on the standard comment unit. 
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Format for pass 1 
C olumn 
1 and 2 
3 through 6 

6 and 7 
8 and 9 

10 through 19 
Format for pass 3 
C olumn 
1 through 6 

7 and 8 

9 through 18 


and 2 error messages: 
Contents 

4-digit line number 
2-character error code 

'1' '!' 'r '1' 'I* 

error messages: 
Contents 


2-character error code 


The error codes and their meanings are given in Apoeridix D. 


5.2.2 CROSS-REFERENCE LISTING 

Cross-references are listed at the end of an assembly listing if the option C was specified 
by the user. Cross-references wUl also be listed if no OPT statement was found, since 
the C option is a default option. 

The cross-references are divided into four functional parts: 

1. Equivalences 

2. Symbols 

3. Externals 

4. Symbols in alphabetical order 

If cross-references are to be listed and there is not enough core to process all four parts 
of the cross-references listing, then the assembler attempts to sort the symbol table 
alphabetically. If there is not enough core to sort the symbol table alphabetically, the 
symbol table is dumped. 

The equivalences, symbols, and externals are listed according to the line number at which 
they are defined. In addition to the definition line number, the value or address and the 
line numbers of all references to that symbol are given. The list of symbols in alphabetical 
order includes all the symbols in the program. The number following each symbol is the 
corresponding definition line. 
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5.2.3 SAMPLE PROGRAM 


The following source program results in the assembly listing in section 5.2.4. 



NAM 

TEST2 ERS MACRO EXAMPLEX 

XYZ 

MAC 

P1,P2,P3.P4, P5. P6 


LDQ 

=N'P5'. 'P6' 

.p4- 

LDA 

'P3' 


'PI' 

'P2' 


ADD 

SYMBl 


IFA 

'P5',NE.O 

11 

IFC 

'Pl'.EQ, MUI 


STA 

SYMB3 


LDA 

EIF 

SYMB2 


EIF 

EMC 

11 

MACRO 

MAC 

P1.P2.P3,P4.P5,P6 


LOC 

A 


LDA 

1 T”» 1 t 

r* 1 


'P2' 

'P3' 


S'P4’Z 

'A'---l 


JMP'P5' 

'P6' 

'A' 

ENA 

EMC 

1 


MACRO 

SYMBl, STA, 'SYMB2,r, 


MACRO 

Q, *, LABELl 

SYMBl 

ADC 

0 

SYMB2 

ADC 

0 


XYZ 

MUI, , SYMB5, , 3 

SYMB5 

ADC 

0 

CALLl 

XYZ 

MUI, 'SYMB4, 1', SYMB5, HERE, 3 

SYMB4 

ADC 

0 

CALL2 

XYZ 

DVI, SYMB7, 'SYMB8, F, THERE, 

SYMB8 

ADC 

0 

SYMB7 

ADC 

END 

0 


5.2.4 SAMPLE LISTING 


The following assembly listing is output from the assembly of the source program in section 

5. 2.3. 


0001 


NAM 

TEST2 ERS MACRO EXAMPLEX 

0002 

XYZ 

MAC 

PI, P2, P3, P4, P5, P6 

0003 


LDQ 

=N'P5', 'P6' 

0004 

'P4' 

LDA 

'P3' 

0005 


'PI' 

'P2' 

0006 


ADD 

SYMBl 

0007 


IFA 

'P5', NE, 0 
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0008 



11 

IFC 

'PI', EQ. MUI 

OOOh 




b'l'A 

SYMB3 

0010 




EDA 

SYMB2 

UUll 




EIF 


0012 




EIF 

11 

0013 




EMC 


nni /I 









IViri J.VV_/ 


JT 1, iT£., r-o, Jr^, 

0015 




EDC 

A 

0016 




EDA 

'PI' 

0017 




'P2' 

'P3' 

0018 




S’P4'Z 

•A'-*-l 

0019 




JMP'P5' 

'P6' 

0020 



'A' 

ENA 

1 

0021 




EMC 


0022 




MACRO SYMBl. STA, 'SY 

0023 




MACRO 

Q. =:% EABEEl 

0023 

POOOO 

C800 





POOOl 

0006 




0023 

P0002 

6900 





P0003 

0005 




0023 

P0004 

0141 




5!c5:s;:s5l< 


: ;;c i'fi 






: ?:< s!? >;? >;< sic s|c s|< 




0023 

P0005 

1000 




0023 

POOOG 

rv A n ■« 
UYY U 1 




0024 

P0007 

0000 

SYMBl 

ADC 

0 

nn*>R 

•pnnnp 

nnnn 

TT* 

A T~\ r' 


0026 




XYZ 

MUI, .SYMB5. . 

0026 

P0009 

EOOO 





POOOA 

0003 




0026 

POOOB 

C800 





POOOC 

0009 




0026 

POOOD 

2400 





POOOE 

0000 




0026 

POOOE 

8800 





POOlO 

FFE6 





^ J ^ ^ ^ ^ ^ ^ 


0026 

POOH 

P0012 

6400 

0000 

0026 

P0013 

P0014 

C800 

FFE3 

0027 

0028 

P0015 

0000 

0028 

P0016 

P0017 

ElOO 

0003 

0028 

P0018 

P0019 

C800 

FFE8 

0028 

POOIA 

POOIB 

2 900 
0007 

0028 

POOIC 

POOID 

8800 

FFE9 

>!« 5jc sj: 5jc ^ J >5e j{< j{< 5}c ^ Si's 

0028 

POOIE 6400 
POOIF 0000 

0028 

P0020 

P0021 

C800 

FFE6 

0029 

P0022 

0000 


SYMB5 ADC 0 

CALLl XYZ MUI, 'SYMB4,r.SYMB5. HERE.3.I 


SYMB4 ADC 0 
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0030 

0030 

P0023 FOOO 
P0024 0002 

CALL2 

XYZ 

DVI. SYMB7. 'SYMB8, 1 

0030 

P0025 C900 
P0026 0005 




0030 

P0027 3800 
P0028 0004 




0030 

P0029 8800 
P002A FFDC 




0031 

P002B 0000 

SYMB8 

ADC 

0 

0032 

P002C 0000 

SYMB7 

ADC 

0 

0033 



END 



'.THERE, 2 
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MNEMONIC INSTRUCTION CODES 


A 


MACHINE INSTRUCTIONS 

There are six classes of machine instruction codes. 


Storage reference. Group A 

Storage reference. Group B 

Register 

Shift 

Skip 

Interregister transfer 


Storage Reference Instructions 


Operation Code 


Definition 


Group A EDA 

LUQ 
ADD 
SUB 
ADQ 
AND 
EOR 
MUI 
DVI 


Load A register 
Load Kci register 
Add to the A register 
Subtract from A register 
Add to Q register 

Perform logical AND with A register 
Perform logical exclusive OR with A register 
Multiply integer with A register 
Divide integer into A register 


Group B 


STA 

Store A register 

STQ 

Store Q register 

JMP 

Unconditional jump 

RTJ 

Return jump 

RAO 

Replace add one in storage 

SPA 

Store A register, return parity to A register 
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Register Instructions 


Operation Code 

Definition 

SLS 

Selective stop 

INP 

Input to A register 

OUT 

Output from A register 

ENA 

Enter A register 

ENQ 

Enter Q register 

INA 

Increase A register 

INQ 

Increase Q register 

NOP 

No operation 

EIN 

Enable interrupt 

IIN 

Inhibit interrupt 

EXl 

Exit interrupt state 

SPB 

Set program protect bit 

CPB 

Clear program protect bit 


Shift Instructions 

ARS 

QRS 

LRS 

ALS 

QLS 

LLS 

Skip Instructions 

SAZ 

SAN 

SAP 

SAM 

SQZ 

SQN 

SQP 

SQM 

SWS 

SWN 

sov 


Skip if A=0 

Skip if A/0 

Skip if A is positive 

Skip if A is negative 

Skip if Q=0 

Skip if Q^O 

Skip if Q is positive 

Skip if Q is negative 

Skip if switch is set 

Skip if switch is not set 

Skip on overflow 


A right shift 
Q right shift 

Long right shift (Q and A combined) 
A left shift 
Q left shift 

Long left shift (Q and A combined) 
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Operation Code 


Definition 


SNO Skip on no overflow 

SPE Skip on storage parity error 

SNP Skip on no storage parity error 

SPF Skip on program protect fault 

SNF Skip on no program protect fault 


Inter-Register Transfer Instructions 


SET 

CLR 

TRA 

TRM 

TRQ 

TRB 

TCA 

TCM 

Trn 

TCB 

AAM 

AAQ 

AAB 

EAM 

EAQ 

EAB 

LAM 

LAQ 

LAB 

CAM 

CAQ 

CAB 


Set specified register to ones 

Clear specified register to zeros 

Transfer A to specified register 

Transfer M to specified register 

Transfer Q to specified register 

Transfer both (Q+M) to specified register 

Transfer complement of A to specified register 


tor* 


mplei 


r*3.risfc2r oomploxi^ont 


-f 


3p6cificci rogistOi 


O { J V. 


^ 1 o t c: i 


Transfer complement of both (Q+M) to specified register 

Transfer arithmetic sum of A and M to specified register 

Transfer arithmetic sum of A and Q to specified register 

Transfer arithmetic sum of A and both (Q+M) to specified 
register 

Transfer exclusive or of A and M to specified register 

Transfer exclusive or of A and Q to specified register 

Transfer exclusive or of A and both (Q+M) to specified 
register 

Transfer logical product of A and M to specified register 

Transfer logical product of A and Q to specified register 

Transfer logical product of A and both (Q+M) to specified 
register 

Transfer complement of logical product of A and M to 
specified register 


Transfer complement of logical product of A and Q to 
specified register 

Transfer complement of logical product of A and both (Q+M) 
to specified register 


Note: + indicates an inclusive OR. 
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PSEUDO INSTRUCTIONS 


There are six classes of pseudo instructions. 

Subprogram linkage 
Data storage 
Constant declaration 
Assembler control 
Listing control 
Macro definition 


Subprogram Linkage 


Operation Code 


Definition 


NAM 

END 

ENT 

EXT 

EXT=:= 


Identify source language subprogram 
End source language subprogram 
Designate internal entry point names 
Designate external entry point names 
Designate relative external entry point names 


Data Storage 


BSS 

Define 

BZS 

Define 

COM 

Define 

DAT 

Define 


a block of storage starting at symbol 
a block of zero storage 
a block of common storage 
a block of data storage 


Constant Declarations 

ADC 

ADC- 

ALF 

NUM 

DEC 

VFD 


Store address constants 
Store relative address constants 
Store an alphanumeric message 
Store numeric constants 

Convert and store decimal constants m fixed point format 
Variable field definition and storage 
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Assembler Control 


Definition 

Equate symbols to addresses 

Defines origin for assem_bly of instructions following ORG 
Terminate ORG 

If condition is true assemble following instructions 
Terminate IFA (or IFC macro pseudo instruction) 

Signal input of control options 
Return control to operating system 


Listing Control 

NLS 
LST 
SPC 

f:jt 

Viacro Deiinixion 

MAC Specify name of macro 

EMC End macro definition 

LOC Define local symbolic labels 

IFC If condition is true assemble following instructions 

in macro 


Inhibit list output 
Resume list output after NLS 
Space lines on list output 
Eject page on list output 


Operation Code 

EQU 

ORG 

ORG- 

IFA 

EIF 

OPT 

:\iON 
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PROGRAMMING CONSIDERATIONS 


B 


CODING TECHNIQUES 

The following limitations should be observed when coding programs to run under 1700 MSOS 
Version 4 in 65K mode. 

All 16 bits of an address word are needed in order to address all of available core. 

This means that bit 15 can no longer be used to indicate the conditions it can be used 
for in a 32K mode system. 

Multilevel indirect addressing cannot be used in 6 5K mode which signifies that instruc- 
tions of the following form can no longer be used. 

ADC (TAG) 

LDA+ (TAG) 

If relative addresses are generated, the following instruction is allowed. 

LDA (TAG) 

The instruction 

ADC (TAG) 

is allowed in 65K mode if there are no storage instructions that make indirect reference 
to this location and the program containing this expression will never be loaded into 
part 1 of a 65K system. 
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ASCII CODES 


C 


The 1963 Control Data Subset of ASCII (CDC-STD 1. 10.003, Revision C) is used by the 
1700 Macro Assembler. ASCII code uses eight bits; the eighth bit, which is always zero, 
is omitted in the following table. 


ASCII 

Symbol 

Bit 

Configuration 

Hexadecimal 

Number 

Meaning 

NULL 

000 0000 

0 

Null /idle 

SOM 

000 0001 

1 

Start of message 

EOA 

000 0010 

2 

End of address 

EOM 

000 0011 

3 

End of message 

EOT 

000 0100 

4 

End of transmission 

WRTI 

000 0101 

5 

Who are you 

RTJ 

000 0110 

6 

Are you 

BELL 

000 0111 

7 

Audible signal 

FE„ 

000 1000 

8 

Format effector 


HT/SK 

000 1001 

9 

Horizontal tab/skip (punched card) 

LF 

000 1010 

A 

Line feed 

'^TAB 

000 1011 

B 

Vertical tabulation 

FF 

000 1100 

c 

Form feed 

CR 

000 1101 

D 

Carriage return 

SO 

000 1110 

E 

Shift out 

SI 

000 1111 

F 

Shift in 

DCq 

001 0000 

10 

Device control/data link escape 

DC^ 

001 0001 



DC2 

001 0010 

12 1 

Device controls 

DC3 

001 0011 

13 J 


DC_j (STOP) 

001 0100 

14 

Device control /stop 

ERR 

001 0101 

15 

Error 

SYNC 

001 0110 

16 

Synchronous idle 

LEM 

001 0111 

17 

Logical end of media 
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ASCII Bit Hexadecimal 


Symbol 

Configuration 

Number 

Meaning 


001 1000 

18 



001 1001 

19 


^2 

001 1010 

lA 


^3 

001 1011 

IB 

Information separators 

^4 

001 1100 

1C 



001 1101 

ID 


^6 

001 1110 

IE 


^7 

001 nil 

IF 


A 

010 0000 

20 

Word separator (space) 

! 

010 0001 

21 

Exclamation point 

tt 

010 0010 

22 

Quotation mark 

# 

010 0011 

23 

Number 

$ 

010 0100 

24 

Dollar sign (hexadecimal) 

% 

010 0101 

25 

Percent 

& 

010 0110 

26 

Ampersand 

' (APOS) 

010 0111 

27 

Apostrophe 

( 

010 1000 

28 

Left parenthesis 

) 

010 1001 

29 

Right parenthesis 

-T* 

010 1010 

2A 

Asterisk 

+ 

010 1011 

2B 

Plus 

, (Comma) 

010 1100 

2C 

Comma 

- 

010 1101 

2D 

Minus 

• 

010 1110 

2E 

Decimal point or period 

/ 

010 nil 

2F 

Slash 

0 

on 0000 

30 


1 

on 0001 

31 


2 

on 0010 

32 


3 

on 0011 

33 


4 

on 0100 

34 

% Numbers 

5 

on 0101 

35 


6 

on 0110 

36 


7 

on 0111 

37 


8 

on 1000 

38 


9 

on 1001 

39 


; 

on 1010 

3A 

Colon 

• 

on 1011 

3B 

Semi-colon 
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ASCII 
Sy ni uol 


Bit 

C Oiii i^urs t ion 


Hexadecimal 

i\ UiliUCl 



mi 

W X X 

1 1 nn 

X X »-/ \J 

o r' 
o 

= 

on 

1101 

3D 

> 

01 1 

1110 

3E 

9 

on 

1111 

3F 

@ 

100 

0000 

40 

A 

100 

0001 

41 

B 

100 

0010 

42 

C 

100 

0011 

43 

D 

100 

0100 

44 

E 

100 

0101 

45 

F 

100 

0110 

46 

G 

100 

0111 

47 

H 

100 

1000 

48 

I 

100 

1001 

49 

.1 

100 

1010 

4 A 

K 

100 

1011 

4B 

L 

100 

1100 

4C 

M 

100 

1101 

4D 

N 

100 

1110 

4E 

O 

100 

1111 

4F 

P 

101 

0000 

50 

Q 

101 

0001 

51 

R 

101 

0010 

52 

S 

101 

0011 

53 

T 

101 

0100 

54 

U 

101 

0101 

55 


101 

0110 

56 

w 

101 

0111 

57 

X 

101 

1000 

58 

Y 

101 

1001 

59 

z 

101 

1010 

5A 

r 

1 

101 

1011 

5B 

\ 

101 

1100 

5C 

1 

101 

1101 

5D 


T\ /T „ ^ 

IViCCtllill^ 
i_/trac3 iiictu 

Equals 
Greater than 
Question mark 
Each 


Letters 


Left bracket 
Reverse slant 
Right bracket 
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ASCII 

Symbol 

Bit 

Configuration 

Hexadecimal 

Number 

Meaning 

t 

101 1110 

5E 

Up arrow (exponentiation) 

- 

101 nil 

5F 

Left arrow (replaced by) 

ACK 

111 1100 

7C 

Acknowledge 

o 

111 1101 

7D 

Unassigned control 

ESC 

111 1110 

7E 

Escape 

DEL 

111 nil 

7F 

Delete/idle 


The numbers between 5F and 7C have no ASCII code assigned to them. 
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MACRO ASSEMBLER ERRORS 


IvIiuSSAui;; SIGNIFICANCE 

**xxxx**yy********** Format for pass 1 and 2 error messages 

Where: xxxx is a 4-digit line number. 

yy is a 2 -character error code 
(explained below). 

******yy********** Format for pass 3 error messages. If the L option 

is selected, errors in pass 3 precede the source line 
on the list output. If L is not selected, error mes- 
sages are output on the standard comment unit. 

ABS BASE ERR Assembler was loaded at a different location from 

where it was absolutized. 

'■''‘‘DS Double defined symbol; a name in: 

• TV.,-. 1 =•-- i ... i. .. .. 

• j. lie:; xuv^dtiuii iicxu ui a uictcixilitj Iii&> 11' UC tiUIi 

or an ALF, NUM, or ADC pseudo instruc- 
tion; or 

• The address field of an EQU, COM, DATA, 
EXT, BSS or a BZS pseudo instruction. 

**EX Illegal expression, either: 

• No forward referencing of some symbolic 
operands; or 

• No relocation of certain expression values; or 

• A violation of relocation; or 

• Illegal register reference; or 

• A symbol other than Q, 1, or B is specified. 

INPUT ERROR An error was returned by driver when doing a Read. 

**LB Numeric or symbolic label contains illegal character. 

rni- J 

J.X1C iauc;i 1£> IgUUl’t^U* 

MASS STORAGE OVERFLOW Not enough room for input image on mass storage. 

*=^MC Macro call error, 

• Illegal parameter list 

• No continuation card where one was indicated. 
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MESSAGE 


SIGNIFICANCE 


**MD 

*=KMO 

**NN 

^=i:OP 

*=>;OV 

**RL 

**SQ 

**UD 


Macro definition error. 

Overflow of load-and-go area; affects only X option. 
Missing or misplaced NAM statement. 

Illegal operation code, either: 

• Illegal symbol in operation code field; or 

• Illegal operation code terminator. 

Numeric constant or operand value is greater than 
allowed. 

Error in previous pass of compilation assembly. See 
output page immediately preceding first page of listing 
for pass 1 or pass 2 error message. 

Illegal relocation, either: 

• Violation of relocation; or 

• Violation of a rule for instructions that 
requires the expression value to either 

be absolute or have no forward referencing 
of symbolic operands. 

Sequence error — Tags instructions with sequence 
numbers that are out of order. This is not fatal and 
is not counted in the number of errors reported at 
the bottom of the symbol table. 

An undefined symbol in an address expression. 
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INDEX 


Absolute addressing 2-1,3 
ADC/ADC* 3-7; A-4 
Address expression 1-3,5 
Address field 1-2 
Address modes 2-1 
Absolute 2-1,3 
Constant 2-1,6 
Relative 2-1,4 
ALF 3-7; A-4 
Arithmetic instructions 2-7 
Arithmetic operators 1-5 
ASCII codes Appendix C 
Assembler control 3-13; A-5 
EIF 3-16 
EQU 3-13 
IFA 3-15 
MON 3-17 
OPT 3-17 

r' / op ri* ~ i A 

Assembler output b-i 
Assembler passes 

1 iii 

2 iii 

3 iii 

Assembly listing 5-2 

Cross reference 5-3 
Error 5-2 

Sample assembly 5-4 
Sample source program 5-4 


BSS 3-4; A-4 
BZS 3-4; A-4 


Control options 5-1 
C 5-1 
L 5-1 
P 5-1 
X 5-1 


DAT 3-6; A-4 
Data storage 3-4; A-4 
BSS 3-4 
BZS 3-4 
COM 3-5 
DAT 3-6 

Data transmission 2-6 


DEC 3-10; A-4 
Handbook) 


I'Ton atqoq 


os tic 


EIF 3-16; A-5 
EJT 3-18; A-5 
EMC 4-2; A-5 
END 3-1; A-4 
ENT 3-2; A-4 
Error listing 5-2 
EQU 3-13; A-5 
Evaluation hierarchy 1-6 
EXT/EXT* 3-2; A-4 


C option 5-1 
COM 3-5; A-4 
Comment field 1-8 
Constant addressing 2-1,6 
Constant declarations 3-7; A-4 
ADC/ADC* 3-7 
ALF 3-7 
DEC 3-10 
NUM 3-9 
VFD 3-11 


IFA 3-15; A-5 
IFC 4-2; A-5 
Instruction format 1-1 
Source program 1-1 
Source statement 1-1 
Address field 1-2 
Comment field 1-8 
Instruction 1-2 
Location field 1-1 
Sequence field 1-8 
Inter-register 2-12 
Inter-register transfer A-3 
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I Jump instructions 2-9 


I L option 5-1 

Listing control 3-18; A- 5 
EJT 3-18 
LST 3-18 
NLS 3-18 
SPC 3-18 
LOG 4-2; A-5 
_ Location field 1-1 
I Logical instructions 2-8 
LST 3-18; A-5 


TvIAC 4-1; A-5 

Machine instructions 2-1; A-1 

Inter- register transfer 2-12; A-3 
Register reference 2-10; A-2 
Shift 2-14; A-2 
Skip 2-15; A-2 
Storage reference 2-1; A-1 
Macro assembler errors Appendix D 
Macro definition instructions A-5 
Macro instructions 4-4 

( Actual parameters 4-4 
Null parameters 4-5 
Examples 4-6 
Macro library 4-10 
Macro pseudo instructions 4-1; A-4 
Macro skeleton 4-3 
Macros 

EMC 4-2 
IFC 4-2 
LCX: 4-2 
MAC 4-1 

Mnemonic instruction codes Appendix A 
MON 3-17; A-5 


NAM 3-1; A-4 

( Negative overflow/ zero set 2-16 
NLS 3-18; A-5 
NUM 3-9; A-4 
Numeric operand 1-4 


Operation code field 1-2 
OPT 3-17; A-5 
I ORG/ORG* 3-14; A-5 


P option 5-1 

Parameters 4-4 
Actual 4-4 
NuU 4-5 

Programming considerations Appendix B 

Pseudo instructions 3-1; A-4 
ADC/ADC* 3-7 
ALF 3-7 
BSS 3-4 
BZS 3-4 
COM 3-5 
DAT 3-6 
DEC 3-10 
EIF 3-16 
EJT 3-18 
END 3-1 
ENT 3-2 
EQU 3-13 
EXT/ EXT* 3-2 
IFA 3-15 
LST 3-18 
MON 3-17 
NAM 3-1 
NLS 3-18 
NUM 3-9 
OPT 3-17 
ORG/ORG* 3-14 
SPC 3-18 
VFD 3-11 


Register reference instructions 2-10 
Relative addressing 2-1,4 


Sample listing 5-4 
Sample program 5-4 
Sequence field 1-8 
Shift instructions 2-14; A-2 
Skip instructions 2-15; A-2 
Source program 1-1 
Source statement 1-1 
SPC 3-18; A-5 
Special characters 1-7 
Index 1-8 
Register 1-7 
Storage 1-7 
Statement label 1-1 

Storage reference instructions 2-1; A-1 
Absolute addressing 2-3 
Address modes 2-1 
Arithmetic 2-7 
Constant addressing 2-6 
Data transmission 2-6 
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Jump 2-9 TABLST iii 

l-<ogical 2-8 

Relative addressing 2-4 
Subprogram linkage 3-1; A-4 
END 3-1 
ENT 3-2 

EXT/EXT* 3-2 VFD 3-11; A-4 

NAM 3-1 

Symbolic operand 1-3 


X option 5-1 
XREF iv 
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